Every KMIP message batch item can have a message extension returned from the server.
This function can be used to return to the caller a server returned extension if one exists. This function must be called only after one of the other functions below are called which perform a specific operation.
- Parameters
-
batchIndex | [ in ] valid values {1..n}, if a response has multiple batch items (e.g., locateAndGet) then each batch item can have a separate extension. |
pExtension | [ out ] server defined extension to the operation, or a response from a client sent extension |
- 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::eInvalidState | A successful call to one of the operations is required before this function is called. |
P6R::eNotFound | There is no message extension that matches the given batchIndex. |
P6R::eInvalidArg | pExtenison is NULL or batchIndex is zero. |
P6R::eFormatError | Parsing error occurred while parsing a KMIP server response. |