WsFindAttribute 関数 (webservices.h)

現在の要素の属性で、指定した名前と名前空間を持つ属性を検索し、そのインデックスを返します。このインデックスは WsReadStartAttribute に渡される可能性があります。

構文

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

パラメーター

[in] reader

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

[in] localName

検索する属性のローカル名。

[in] ns

検索する属性の名前空間。

[in] required

必須が TRUE で 、 属性が見つからない場合、関数は WS_E_INVALID_FORMATを返します。 ( 「Windows Web Services の戻り値」を参照してください)。必須が FALSE で、 属性が見つからない場合、関数は S_FALSEを返します。

[out] attributeIndex

属性が見つかった場合は、 属性のインデックスがここで返されます。 その後、このインデックスを WsReadStartAttribute に渡すことができます。

[in, optional] error

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

戻り値

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

リターン コード	説明
WS_E_INVALID_FORMAT	入力データの形式が正しくないか、予期した値が指定されていませんでした。

注釈

リーダーが開始要素に配置されていない場合は、 WS_E_INVALID_OPERATIONを返します。 ( 「Windows Web Services の戻り値」を参照してください)。

返されるインデックスは、ドキュメントに表示される属性の位置に必ずしも対応するとは限りません。 WS_XML_ELEMENT_NODEの属性の配列内の一致する属性の インデックスを識別します。 この配列内の属性の順序は、ドキュメントに属性が表示された順序とは異なる場合があります。

要件

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