Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPRequest3::addDecryptRequest2 ( P6KMIP_CRYPTOIN  decryptParams,
P6KMIP_CRYPTOSTREAM pStreamState,
P6KMIP_MSGEXTENSION pExtension 
)
pure virtual

Add the decrypt batch item to the current request message.

A successful startRequestMsg function must be called first. Passing in a non-null P6KMIP_CRYPTOSTREAM definition will generate the appropriate streaming decryption operation for the batch item. Streaming operation decrypts data a chunk at a time over multiple KMIP server calls.

Decrypt (Section 4.30 KMIP spec), this operation requests the server to decrypt data with a specific key.

Parameters
decryptParams[ in ] the set of parameters that are used to generate a decrypt request.
pStreamState[ in ] optional can be NULL, the current state of the decryption stream operation (i.e., initial, update, final)
pExtension[ in ] optional can be NULL, vendor defined extension to the operation
Returns
SuccessP6R::eOk 
FailureP6R::eNotInitializedA successful call to intialize() must be made before calling this funciton.
P6R::eTooSmallThe configured buffer size in pPool is too small to hold the generated message.
P6R::eInvalidStateA successful call to startRequestMsg() must be made before calling this function.
P6R::eInvalidArgInvalid pStreamState parameter settings.
P6R::eExistsif pStreamState != NULL, then encryptParams.pParams and encryptParams.IV.pString should only be set for KMIP_STREAM_INITIAL
P6R::eRangepExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure