次の方法で共有

WsRemoveMappedHeader 関数 (webservices.h)

  • [アーティクル]

マップされたヘッダーのすべてのインスタンスをメッセージから削除します。

構文

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] message

ヘッダーを設定するメッセージ。

メッセージは、 WS_MESSAGE_STATE_EMPTY以外の任意の状態にすることができます。

[in] headerName

削除するマップされたヘッダーの名前。

[in, optional] error

関数が失敗した場合に追加のエラー情報を格納する場所を指定します。

戻り値

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

リターン コード 説明
E_INVALIDARG
 1 つ以上のパラメーターが正しくありません。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

メッセージには、メッセージ エンベロープの一部ではない追加のトランスポート固有の情報が含まれている場合があります。 このトランスポート固有の情報は、Message オブジェクトのヘッダーとしてプログラムで公開できます。 この関数は、メッセージ オブジェクトからマップされたヘッダーを削除するために使用されます。 これは、カスタム チャネル実装で使用して、メッセージを送信する前にマップされたヘッダーを削除できます。

要件

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