Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
virtual P6R::P6ERR P6R::p6IKMIPClient::cancel ( P6BCSTR  asynchCorrelation,
P6KMIP_MSGEXTENSION pExtension,
P6KMIP_RESULT pResult,
P6UINT32 pCancelResult 
)
pure virtual

Cancel a pending KMIP server request.

It is possible that the KMIP server will not be able to cancel a request and this request will fail. Note, that the KMIP server will return the asynchCorrelation in the cancel response message, which we return to the caller in the pResult->pAsynchCorrelation field.

Parameters
asynchCorrelation[ in ] a handle previously returned by the KMIP server to be used as an identifier for a pending request
pExtension[ in ] optional can be NULL, vendor defined extension to the operation
pResult[ out ] Server returned status indicators
pCancelResult[ out ] see Section 9.1.3.2.25 in p6kmip.h, results of attempt to cancel the operation indicated by the "asynchCorrelation" parameter.
Returns
FailureP6R::eNotInitializedA successful call to initialize() is required.
P6R::eNotConnA successful call to open() is required before this function is called.
P6R::eInvalidArgOne of the pointers is NULL.
P6R::eFormatErrorParsing error occurred while parsing a KMIP server response.
P6R::eTooBigMessage returned by server is too big to fit in configured buffers.
P6R::eTooSmallThe configured buffer size in P6KMIP_PREF.maxBufferSize is too small to hold the request message.