Add the get batch item to the current request message.
A successful startRequestMsg function must be called first.
Get (Section 4.11 KMIP spec), this operation requests a single managed object (e.g., a key, template, certificate) to be returned identified by a unique identifer.
- Parameters
-
uniqueIdentifier | [ in ] optional uniqueIdentifier.pString can be NULL, pointer to the managed object to return. If NULL the server determines the object to return. |
pKeyFormat | [ in ] optional can be NULL, if a key is being returned specify its format, see Section 9.1.3.2.3 in p6kmip.h, Key Format Type Enumeration |
pKeyCompression | [ in ] optional can be NULL, if a key is being returned specify the compression being used, see Section 9.1.3.2.2 in p6kmip.h, Key Compression Type Enumeration |
pSpec | [ in ] optional can be NULL, can be used for all managed objects except templates, specifies how to return an object wrapped (i.e., encrypted and/or signed) |
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 |