Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPRequest::addCertifyRequest ( P6NCSTR  uniqueIdentifier,
P6UINT32  requestType,
P6BCSTR  certificateRequest,
P6KMIP_TEMPLATEATTRIBUTE pAttributes,
P6KMIP_MSGEXTENSION pExtension 
)
pure virtual

Add the certify batch item to the current request message.

A successful startRequestMsg function must be called first.

Certify (Section 4.7 KMIP spec), allows the KMIP client to request that a certificate be generated for the specified (via the uniqueIdentifier parameter or the server selects) public key.

Parameters
uniqueIdentifier[ in ] optional uniqueIdentifier.pString can be NULL, pointer to the public key to certify (if NULL the server selects the public key)
requestType[ in ] Certificate request type, one of the values from Section 9.1.3.2.21 in p6kmip.h
certificateRequest[ in ] a byte string which can represent several different certificate request formats (e.g., PEM, PGP)
pAttrbutes[ in ] optional can be NULL, any of the defined attributes to be associated with the registered object (e.g., Object Group)
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