Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPClient3::getServerCorrelationValue ( p6IKMIPStr **  pCorrelation)
pure virtual

Client and Server Correlation Values where added in KMIP 1.4 to assist in processing logs and to help deterime what may have happened to a client request.

Both correlation values will appear in the KMIP logs, but if an application needs to pull the server generated correlation value out of a message (if one is prsent) then this function can be used.

This function must be called only after one of the other functions above are called which perform a specific operation.

Parameters
pCorrelation[ in ] the calling function returns an enumerator that holds the Server Correlation Value
Returns
FailureP6R::eNotInitializedA successful call to initialize() is required.
P6R::eInvalidStateA successful call to one of the operations is required before this function is called.
P6R::eNotFoundThere is no server correlation value in the last received message.
P6R::eInvalidArgpCorrelation is NULL.
P6R::eFormatErrorParsing error occurred while parsing a KMIP server response.