Functions | |
MQERETURN | mqeMTrustAttribute_new (MQeExceptBlock *pErrStruct, MQeMTrustAttributeHndl *phAttribute, MQeAuthenticatorHndl hAuthenticator, MQeCryptorHndl hCryptor, MQeCompressorHndl hCompressor) |
This function constructs an MQeMTrustAttribute object. | |
MQERETURN | mqeMTrustAttribute_free (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct) |
frees the MQeMTrustAttribute handle hMTrustAttribute | |
MQERETURN | mqeMTrustAttribute_decodeData (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQEBYTE *pBuffer, MQEINT32 *pBufLength, MQEBYTE *pData, MQEINT32 offset, MQEINT32 length) |
decrypts and/or decompresses the bytes referenced by pData, offset and for length length. | |
MQERETURN | mqeMTrustAttribute_encodeData (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQEBYTE *pBuffer, MQEINT32 *pBufLength, MQEBYTE *pData, MQEINT32 offset, MQEINT32 length) |
This function encrypts and/or compresses the bytes referenced by pData, offset and for length length. | |
MQERETURN | mqeMTrustAttribute_setHomeServer (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQECONST MQeStringHndl hHomeServer) |
This function sets the Home Server address and port for this attribute. | |
MQERETURN | mqeMTrustAttribute_setPublicRegistry (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQePublicRegistryHndl hPublicRegistry) |
This function sets the public registry for this attribute. | |
MQERETURN | mqeMTrustAttribute_setPrivateRegistry (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQePrivateRegistryHndl hPrivateRegistry) |
Sets the private registry for this attribute. | |
MQERETURN | mqeMTrustAttribute_setTarget (MQeMTrustAttributeHndl hMTrustAttribute, MQeExceptBlock *pErrStruct, MQECONST MQeStringHndl hTarget) |
Adds the name of the intended recipient to the attribute. This is used to retrieve the recipient's public key, in order to encrypt the message. |
This object is used to create an attribute object enabling message-level protection of message objects in such a way that :
|
|
|
|
|
|
|
|
|
Called to set an MQeMTrustAttributes home-server address. When used to protect a message, encodeData attempts to get the intended recipient’s mini-certificate from its active public registry. If not found but the home-server address is set, it requests the mini-certificate from the home-server, and saves it for subsequent use in the active public registry. When used to recover a message, decodeData attempts to gets the initiator’s mini-certificate from its active public registry. If not found but the home-server address is set, it requests the mini-certificate from the home-server and saves it for subsequent use in its active public registry.
|
|
Called to set an MQeMTrustAttribute’s active public registry. When used to protect a message this is a public registry that has (or gets) the mini-certificate of the intended recipient, and when recovering a message this is a public registry that has (or gets) the mini-certificate of the sender.
|
|
Called to set an MQeMTrustAttribute’s active private registry. When used to protect a message this is the private registry of the sender and when recovering a message this is the private registry of the recipient.
|
|
This method adds the name of the intended recipient to the attribute. This is used to retrieve the recipient’s public key, in order to encrypt the message. It is also added to the message and used at the destination to retrieve the recipient’s private registry, to enable decryption of the message. This should be used in preference to the method setTargetRegistryName() in the class MQePrivateRegistry. If both setTarget() and setTargetRegistryName() are called, the name specified in setTarget() is used.
|