WsGetHeaderAttributes 関数 (webservices.h)

  • [アーティクル]

この関数は、リーダーが配置されているヘッダー要素の WS_HEADER_ATTRIBUTES を ULONG パラメーターに設定します。 メッセージのエンベロープ バージョンは、返す属性を決定するために使用されます。

構文

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] message

クエリを実行するメッセージを含む WS_MESSAGE 構造体へのポインター。 このエンベロープ バージョンのメッセージは、どの属性が一致するかを判断するために使用されます。 メッセージは、WS_MESSAGE_STATE_EMPTYを除く任意 の状態にすることができます。

[in] reader

クエリを実行するリーダーへのポインター。 これは 、WsCreateReader から返されるオブジェクトWS_XML_READER有効である必要があり、 NULL にすることはできません。

[out] headerAttributes

成功すると、このポインターによって参照される値がヘッダー属性に設定されます。

[in, optional] error

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

戻り値

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

リターン コード 説明
E_OUTOFMEMORY
 メモリ不足。
E_INVALIDARG
 1 つ以上の引数が無効です。
WS_E_INVALID_FORMAT
 入力データの形式が正しくないか、予期した値が指定されていませんでした。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

リーダーはヘッダー要素を指していると見なされます。 XML リーダー API を使用して、リーダーを適切に配置します。

要件

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