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

Add the get usage allocated batch item to the current request message.

A successful startRequestMsg function must be called first.

Get Usage Allocation (Section 4.18 KMIP spec), this operation requests an usage allocation of a managed object used for applying cryptographic protection

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.
usageLimitsCount[ in ] an allocation amount from the current Usage Limits value to allow the client to use the managed cryptographic object (specified by the unique identifier parameter) for applying cryptographic protection
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