WsResetMessage 関数 (webservices.h)

メッセージの状態を WS_MESSAGE_STATE_EMPTYに戻します。 この状態では、Message オブジェクトを再利用できます。

構文

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

パラメーター

[in] message

リセットする Message オブジェクトへのポインター。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

注釈

メッセージがリセットされると、その基になるヒープがリセットされます。

メッセージ オブジェクトを再利用して複数のメッセージを受信または送信することは、通常、各メッセージのメッセージ オブジェクトを作成して解放するよりも効率的です。

要件