WsReadQualifiedName 函数 (webservices.h)

读取限定名称,并根据XML_READER的当前命名空间范围将其分为前缀、localName 和命名空间。 如果指定了 ns 参数,则将返回前缀绑定到的命名空间,或 返回WS_E_INVALID_FORMAT 。 (请参阅 Windows Web Services 返回值。) 字符串放置在指定的堆中。

语法

HRESULT WsReadQualifiedName(
  [in]           WS_XML_READER *reader,
  [in]           WS_HEAP       *heap,
                 WS_XML_STRING *prefix,
  [out]          WS_XML_STRING *localName,
                 WS_XML_STRING *ns,
  [in, optional] WS_ERROR      *error
);

参数

[in] reader

应读取限定名称的读取器。

[in] heap

应为其分配生成的字符串的堆。

prefix

此处返回限定名称的前缀。

[out] localName

此处返回限定名称的 localName。

ns

此处返回限定名称绑定到的命名空间。

[in, optional] error

如果缺少 localName,函数将返回 WS_E_INVALID_FORMAT
如果指定了 ns 参数,但前缀未绑定到命名空间,则将返回 WS_E_INVALID_FORMAT

返回值

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

返回代码 说明
WS_E_INVALID_FORMAT
输入数据未采用预期格式或没有预期值。

要求

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