次の方法で共有

WsMarkHeaderAsUnderstood 関数 (webservices.h)

  • [アーティクル]

この関数は、アプリケーションによってヘッダーを "理解" としてマークします。

ヘッダーのセットは拡張可能であり、受信側によるメッセージ同化には送信者がアクセスできません。 この関数は、受信したヘッダーが読み取られて理解されたことを送信者に認識させるための受信側アプリケーション メソッドです。

メモ この関数は、アプリケーションがヘッダーを理解する必要があることを示すメッセージを受信し、 WsGetHeader または WsGetCustomHeader を使用してヘッダーを取得しなかった場合にのみ使用する必要があります。

WS_MESSAGE_STATEは WS_MESSAGE_STATE_READING に設定されている必要があります。 見る。詳細については、WsCheckMustUnderstandHeaders を参照してください。

 

構文

HRESULT WsMarkHeaderAsUnderstood(
  [in]           WS_MESSAGE                 *message,
  [in]           const WS_XML_NODE_POSITION *headerPosition,
  [in, optional] WS_ERROR                   *error
);

パラメーター

[in] message

マークするヘッダーを含む Message オブジェクトへのポインター。

[in] headerPosition

XML ヘッダー セグメント内のヘッダー要素の位置へのポインター。

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_E_INVALID_OPERATION
 メッセージが正しい状態ではありません。
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリ不足。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

アプリケーションは、XML リーダーを使用してヘッダーを読み取るときに、ヘッダー要素の WS_XML_NODE_POSITION を取得し、この関数に渡す必要があります。 WS_XML_NODE_POSITIONを取得する方法については、「WsGetReaderPosition」を参照してください。

要件

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