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
 一个或多个参数无效。
S_FALSE
 找不到 xml 属性。

注解

此函数只能用于获取使用前缀“xml”的范围中的属性值。

如果未找到匹配的 xml 属性，将为值返回零长度字符串，并且函数返回S_FALSE。

读取器不对 xml 属性执行任何其他操作，但不会显示它们以供检查。

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 webservices.h
Library WebServices.lib
DLL WebServices.dll