This function sends the combination of a locate operation followed by a check operation to a KMIP server.
The check operation is used to verify if the results of the locate operation meet specific requirements before they are returned to the caller. Note that the locate can still return one or more unique indentifiers while the check operation failed. Thus the caller has to check both pResult and pCheck result parameters. The check result can indicate a unique identifier that failed one of the check parameters.
- Parameters
-
locate | [ in ] the group of parameters specific to the lcoate operation |
check | [ in ] the group of parameters specific to the check operation |
ppUniqueId | [ out ] An enumerator returning all matching unique identifiers |
pResult | [ out ] Server returned status of the locate operation |
pCheck | [ out ] Server returned status of the check operation |
- 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. |