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

Add the archive batch item to the current request message.

A successful startRequestMsg function must be called first.

Archive (Section 4.22 KMIP spec), this operation requests is used to specify that a managed object may be archived. The actual archive process is controlled by policies defined in the key management server.

Parameters
uniqueIdentifier[ in ] optional uniqueIdentifier.pString can be NULL, the managed object to obtain the lease on. If NULL the sserver determines the object to query.
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