Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPClient2::locateAndPageObjects ( P6KMIP_LOCATEPARAMS  locate,
P6UINT32  offsetItems,
p6IKMIPStr **  ppUniqueId,
P6INT32 pLocatedItems,
P6KMIP_RESULT pResult 
)
pure virtual

Locate zero or more managed objects that match the given attributes list allowing the caller to page though the search results by specifying an offset into the search results to start at the next page.

Note that is method always run in synchronous mode. This functionality was added to KMIP Version 1.3.

Parameters
locate[ in ] the group of parameters specific to the lcoate operation
offsetItems[ in ] start returning the set of matching unique identifers by skipping the first "offsetItems" search results, thus defining the next page
ppUniqueId[ out ] An enumerator returning all matching unique identifiers
pLocateItems[ out ] the number of total matching unique identifers to the search critera, a -1 is returned if the server did not provide a value
pResult[ out ] Server returned status indicators
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.
P6R::eInvalidVersionPaging support was adding in KMIP 1.3 and cannot be used in eailer versions.