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 オブジェクトへのポインター。

戻り値

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

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll