マップされたヘッダーのすべてのインスタンスをメッセージから削除します。
構文
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
関数が失敗した場合に追加のエラー情報を格納する場所を指定します。
戻り値
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
1 つ以上のパラメーターが正しくありません。 |
|
この関数は、上記以外のエラーを返す場合があります。 |
注釈
メッセージには、メッセージ エンベロープの一部ではない追加のトランスポート固有の情報が含まれている場合があります。 このトランスポート固有の情報は、Message オブジェクトのヘッダーとしてプログラムで公開できます。 この関数は、メッセージ オブジェクトからマップされたヘッダーを削除するために使用されます。 これは、カスタム チャネル実装で使用して、メッセージを送信する前にマップされたヘッダーを削除できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | webservices.h |
| Library | WebServices.lib |
| [DLL] | WebServices.dll |