WsGetXmlAttribute 関数 (webservices.h)

指定した localName を持つスコープ内で最も近い xml 属性を検索し、その値を返します。
戻り値は、指定されたヒープに配置されます。

構文

HRESULT WsGetXmlAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           WS_HEAP             *heap,
                 WCHAR               **valueChars,
  [out]          ULONG               *valueCharCount,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] reader

xml 属性を検索するリーダー。

[in] localName

検索対象の xml 属性の localName。

[in] heap

結果の値を割り当てるヒープ。

valueChars

属性の値はここに格納されます。

[out] valueCharCount

valueChars の長さ。

[in, optional] error

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

戻り値

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

リターン コード	説明
E_INVALIDARG	1 つ以上の引数が無効です。
S_FALSE	xml 属性が見つかりませんでした。

注釈

この関数は、プレフィックス "xml" を使用するスコープ内の属性の値を取得するためにのみ使用できます。

一致する xml 属性が見つからない場合は、値に対して長さ 0 の文字列が返され、関数は S_FALSEを返します。

リーダーは、検査のために表示する以外に xml 属性を使用して何も行いません。

要件

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