Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPRequest2::addObtainLeaseRequest ( P6NCSTR  uniqueIdentifier,
P6KMIP_MSGEXTENSION pExtension 
)
pure virtual

Add the obtain lease batch item to the current request message.

A successful startRequestMsg function must be called first.

Obtain Lease (Section 4.17 KMIP spec), this operation requests a lease (i.e., an interval of time) on a managed object controlling its cached state.

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.
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