WS_MESSAGE_DONE_CALLBACK function

Notifies the caller that the message has completed its use of either the WS_XML_READER structure that was supplied to WsReadEnvelopeStart function, or of the WS_XML_WRITER structure supplied to the WsWriteEnvelopeStart function.

Syntax

void WS_MESSAGE_DONE_CALLBACK(
  _In_ void *doneCallbackState
);

Parameters

doneCallbackState [in]

A pointer to state information passed to the WsReadEnvelopeStart or WsWriteEnvelopeStart function.

This parameter can be used to specify a pointer to user-defined data required by the callback.

Return value

This function does not return a value.

Security

The callback should not access the message object, since it may already have been freed.

Remarks

This callback can be used as an indicator that the message object is no longer using the reader or writer.

The callback is specified when WsReadEnvelopeStart or WsWriteEnvelopeStart is called.

The callback should assume that it is invoked as a WS_SHORT_CALLBACK, since it will be invoked on the same thread that calls WsFreeMessage or WsResetMessage.

Requirements