Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPClient::locateAndGetObject ( P6KMIP_LOCATEPARAMS  locate,
P6KMIP_GETPARAMS  get,
P6KMIP_MANAGED pObject,
P6KMIP_RESULT pLocateResult,
P6KMIP_RESULT pGetResult 
)
pure virtual

This function sends the combination of a locate operation followed by a get operation to a KMIP server.

If the locate operation was successful, then the second get operation should return the found object in the pObject parameter. Thus the caller has to check both pLocateResult and pGetResult result parameters to determine if there was a failure.

Parameters
locate[ in ] the group of parameters specific to the lcoate operation
get[ in ] the group of parameters specific to the get operation
pObject[ out ] P6KMIP_MANAGED containing a managed object returned by the server
pLocateResult[ out ] Server returned status of the locate operation
pGetResult[ out ] Server returned status of the get operation
Returns
FailureP6R::eNotInitializedA successful call to initialize() is required.
P6R::eNotConnA successful call to open() is required before this function is called.
P6R::eInvalidArgOne of the pointers is NULL, or queryCount is zero.
P6R::eFormatErrorParsing error occurred while parsing a KMIP server response.
P6R::eTooBigMessage returned by server is too big to fit in configured buffers.
P6R::eTooSmallThe configured buffer size in P6KMIP_PREF.maxBufferSize is too small to hold the request message.