Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPResponse::addGetRawKeyResponse ( P6KMIP_RESPONSEPARAMS  result,
P6NCSTR  uniqueIdentifier,
P6KMIP_RAWKEY  keyInfo,
P6KMIP_MSGEXTENSION pExtension 
)
pure virtual

Add the get batch item to the current response message.

A successfull startResponseMsg function must be called first. Get Symmetric, Public, or Private key (Section 4.11), this function encodes the result of an addGetRequest in a response message. This function is used when the key to return cannot be presented in the p6ICryptoKey object. The key returned via this function will be unwrapped (i.e., not encrypted nor signed).

This function requires that the caller has properly encoded in TTLV the Key Block's Key Material field. The keyInfo->keyMaterial value will be written directly into the message's Key Material field and must be a multiple of 8 bytes (a standard KMIP encoding requirement).

Parameters
result[ in ] a standard set of parameters that can be set for any response (e.g., error codes, unique Id of matching request)
uniqueIdentifier[ in ] pointer to the managed object returned
keyInfo[ in ] all the key information needed to compose a Key Block structure
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 startResponseMsg() must be made before calling this function.
P6R::eRangepExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure
P6R::eRangepKey->keyMaterial.length must be a multiple of 8, since encoded as Key Material field
P6R::eFormatErrorkeyInfo->objectType does not indicate a key object