Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPResponse::addGetKeyResponse ( P6KMIP_RESPONSEPARAMS  result,
P6NCSTR  uniqueIdentifier,
P6KMIP_KEY  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. The key returned via this function will be unwrapped (i.e., not encrypted nor signed).

This function selects a default encoding for the pKey parameter, but the caller can request to override the default (e.g., selecting "KMIP_KEYFORMAT_PKCS1" which is PKCS#1 instead of "KMIP_KEYFORMAT_TRANRSAPUBKEY" which is Transparent RSA Public Key).

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 ] key material and relevant meta data to be included in the response
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::eNotSupportedValue for pKeyFormatType is not supported.
P6R::eWrongKeyClassValue for pKeyFormatType is not appropriate for the pKey class (e.g., for PKCS key must be asymmetric).
P6R::eRangepExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure