通过

WsGetPrefixFromNamespace 函数 (webservices.h)

  • 项目

此函数返回命名空间绑定到的前缀。 作用域中可能有多个前缀，此函数可以自由返回其中任何一个前缀。

注意 在任何情况下，当可以返回多个前缀时，调用方都不应依赖或期望返回特定的前缀。
 

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

如果调用 WsWriteStartElement ，但未提交元素引用的命名空间和前缀，并且元素上的任何属性都不适用于此函数。

语法

HRESULT WsGetPrefixFromNamespace(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
                 const WS_XML_STRING **prefix,
  [in, optional] WS_ERROR            *error
);

参数

[in] writer

指向编写器的指针，其中包含要搜索的命名空间。 这必须是 WsCreateWriter 返回的有效WS_XML_WRITER对象，并且不能为 NULL。

[in] ns

要搜索的命名空间。

[in] required

指示如果未找到匹配的前缀，是否应返回错误。

prefix

对绑定到命名空间的前缀的引用;如果所需参数的值为 FALSE 且找不到匹配的命名空间，则为 NULL。

注意 返回的值仅在编写器前进之前有效。

 

[in, optional] error

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

返回值

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

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

注解

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

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

不应修改返回的前缀，并且仅在编写器前进之前有效。

要求

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