Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPClient::extractExtension ( P6UINT16  batchIndex,
P6KMIP_RESPEXTENSION pExtension 
)
pure virtual

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
FailureP6R::eNotInitializedA successful call to initialize() is required.
P6R::eNotConnA successful call to open() is required before this function is called.
P6R::eInvalidStateA successful call to one of the operations is required before this function is called.
P6R::eNotFoundThere is no message extension that matches the given batchIndex.
P6R::eInvalidArgpExtenison is NULL or batchIndex is zero.
P6R::eFormatErrorParsing error occurred while parsing a KMIP server response.