WsGetNamespaceFromPrefix 函数 (webservices.h)

此函数从绑定到的前缀返回命名空间。

如果 所需 参数的值设置为 TRUE ,并且 Prefix 未绑定到任何命名空间,则将返回 WS_E_INVALID_FORMAT 异常。 (请参阅 Windows Web Services 返回值。) 如果 所需的 参数为 FALSE,并且 Prefix 未绑定到任何命名空间, 则 ns 参数将为 NULL ,并且函数将返回S_FALSE。

语法

HRESULT WsGetNamespaceFromPrefix(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *prefix,
  [in]           BOOL                required,
                 const WS_XML_STRING **ns,
  [in, optional] WS_ERROR            *error
);

参数

[in] reader

指向应为其搜索前缀的读取器的指针。

[in] prefix

指向要搜索的前缀的指针。

[in] required

此布尔参数的值确定如果未找到匹配的命名空间,是否应返回错误。

ns

对前缀绑定到的命名空间的引用(如果成功)。 返回的值仅在编写器前进之前有效。

[in, optional] error

指向 WS_ERROR 对象的指针,如果函数失败,应存储有关错误的其他信息。

返回值

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

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

注解

对于前缀“xml”,它将返回命名空间“http://www.w3.org/XML/1998/namespace"”。

对于前缀“xmlns”,它将返回命名空间“http://www.w3.org/2000/xmlns/"”。

要求

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