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
Success | P6R::eOk | |
Failure | P6R::eNotInitialized | A successful call to intialize() must be made before calling this funciton. |
P6R::eTooSmall | The configured buffer size in pPool is too small to hold the generated message. |
P6R::eInvalidState | A successful call to startRequestMsg() must be made before calling this function. |
P6R::eRange | pExtension->encodedExtension.length must be a multiple of 8, since encoded as the Vendor Extension Structure |