通过

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 返回 Values.) 如果需要为 FALSE 且找不到属性，则函数将返回S_FALSE。

[out] attributeIndex

如果找到该属性，则在此处返回属性的索引。 然后，可以将此索引传递给 WsReadStartAttribute。

[in, optional] error

指定在函数失败时应存储其他错误信息的位置。

返回值

此函数可以返回其中一个值。

返回代码 说明
WS_E_INVALID_FORMAT
 输入数据的格式不是预期的，或者没有预期的值。

注解

如果读取器未定位在 start 元素上，则它将返回 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