Add the check batch item to the current request message.
A successful startRequestMsg function must be called first.
Check (Section 4.10 KMIP spec), if the key managementserver determines that the client is allowed to use the object according to the specified parameters, then the server returns the Unique Identifier of the object.
- Parameters
-
uniqueIdentifier | [ in ] optional uniqueIdentifier.pString can be NULL, pointer to the managed object to verify access to. If NULL the server determines the object to check access. |
pUsageLimitsCount | [ in ] optional can be NULL, defines the number of usage limits units to be checked against server policy. |
pUsageMask | [ in ] optional can be NULL, defines the Cryptographic Usage for which the client intends to use the object. |
pLeaseTime | [ in ] optional can be NULL, interval type, time value that the client is asking the server to validate against server policy. |
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 |