Add the register batch item for a meta-data only object (MDO).
A successful startRequestMsg function must be called first.
Register (Section 4.3 KMIP spec), allows the KMIP client to send one of several MDOs to the server for storage. This call is used to send meta data for one the following objects: {Symmetric Key, Private Key, Public Key, PGP Key}.
- Parameters
-
objectType | [ in ] one of the key values from Section 9.1.3.2.12 in p6kmip.h, Object Type Enumeration |
cryptoAlg | [ in ] one of the values from Section 9.1.3.2.13 in p6kmip.h, Cryptographic Algorithm Enumeration |
cyrptoLength | [ in ] key size in bites |
attrbutes | [ in ] The required attribues {Cryptographic Algorithm, Cryptographic Length, Cryptographic Usage}, and any other attributes to be associated with the new key object (e.g., Object Group) |
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 |