Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPRequest::addReKeyRequest ( P6NCSTR  uniqueIdentifier,
P6UINT32 pOffset,
P6KMIP_TEMPLATEATTRIBUTE pAttributes,
P6KMIP_MSGEXTENSION pExtension 
)
pure virtual

Add the re-key batch item to the current request message.

A successful startRequestMsg function must be called first.

Re-key (Section 4.4 KMIP spec), allows the KMIP client to request the re-generation of a symmetric key to replace an existing key.

Parameters
uniqueIdentifier[ in ] optional uniqueIdentifier.pString can be NULL, pointer to the symmetric key to replace
pOffset[ in ] optional can be NULL, an interval value to indicate the difference between the initialization date and the activation date
pAttrbutes[ in ] optional can be NULL, any of the defined attributes to be associated with the registered object (e.g., Object Group)
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::eRangepExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure