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

Sets the Client Correlation Value for the next KMIP message.

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

This function can be called multiple times. On each call any prior value set is replaced by the new value. If pCorrelation.pString is NULL, then the prior value (if any) is freed and no correlation value is sent to the server.

Parameters
pCorrelation[ in ] Contains a caller's generated correlation value to pass to the server.
Returns
SuccessP6R::eOk 
FailureP6R::eNotInitializedA successful call to initialize() is required.
P6R::eInvalidArgpCorrelation is NULL