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
Failure | P6R::eNotInitialized | A successful call to initialize() is required. |
P6R::eNotConn | A successful call to open() is required before this function is called. |
P6R::eInvalidArg | One of the pointers is NULL, or queryCount is zero. |
P6R::eFormatError | Parsing error occurred while parsing a KMIP server response. |
P6R::eTooBig | Message returned by server is too big to fit in configured buffers. |
P6R::eTooSmall | The configured buffer size in P6KMIP_PREF.maxBufferSize is too small to hold the request message. |
P6R::eInvalidVersion | Paging support was adding in KMIP 1.3 and cannot be used in eailer versions. |