WsWriteEnvelopeStart function

Writes the start of the message including the current set of headers of the message and prepares to write the body elementss. This function is designed for writing messages to destinations other than channels. To write a message to a channel use WsWriteMessageStart.

Syntax

HRESULT WINAPI  WsWriteEnvelopeStart(
  _In_     WS_MESSAGE*              message,
  _In_     WS_XML_WRITER*           writer,
  _In_opt_ WS_MESSAGE_DONE_CALLBACK doneCallback,
  _In_opt_ void*                    doneCallbackState,
  _In_opt_ WS_ERROR*                error
);

Parameters

message [in]

A pointer to the Message object to write. The pointer must reference a valid WS_MESSAGE object.

writer [in]

A pointer to the XML Writer object to write the Message. The Message object uses the Writer in subsequent calls to write the message. The caller must keep the writer valid until WsResetMessage or WsFreeMessage is called. The WS_MESSAGE_DONE_CALLBACK parameter can be used to determine that the WS_XML_WRITER is no longer in use.

doneCallback [in, optional]

The callback function invoked when the Message is released or reset. This callback can be used to indicate that the WS_XML_WRITER object is no longer in use by this message. If this function fails the callback is not called. If the function succeeds the callback is invoked one time only.

doneCallbackState [in, optional]

A void pointer to a user-defined state that will be passed to the specified callback. This parameter may be NULL.

error [in, optional]

A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.

Return value

This function can return one of these values.

Remarks

The start of the message, including the current set of headers that exist in the message, are written to the writer.

The message state must be set to WS_MESSAGE_STATE_INITIALIZED. On success the Message state transitions to WS_MESSAGE_STATE_WRITING. On failure state transition does not occur.

To write an element of the message body use WsWriteBody. To write directly to the Writer of the Message obtain the Reader with the WS_MESSAGE_PROPERTY_ID set to WS_MESSAGE_PROPERTY_BODY_WRITER property.

Requirements