WsWriteQualifiedName 函数 (webservices.h)

将 XML 限定名称写入编写器。

语法

HRESULT WsWriteQualifiedName(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in, optional] const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

参数

[in] writer

指向将限定名称写入到 的 WS_XML_WRITER 对象的指针。 指针必须引用有效的 XML 编写器 对象。

[in, optional] prefix

指向限定名称使用的前缀的WS_XML_STRING指针。 如果此参数引用的值为 NULL ，则编写器将选择前缀。

[in] localName

指向限定名称使用的本地名称的WS_XML_STRING指针。 长度必须至少为一个字符。

[in, optional] ns

指向用于限定名称的命名空间的WS_XML_STRING指针。

如果未指定前缀，编写器可能会在范围中使用绑定到指定命名空间的前缀，或者可能会生成前缀并包含 XMLNS 属性。

如果指定了前缀，编写器将使用该前缀，并可以包含 XMLNS 属性（如果需要）来替代范围内的现有前缀。

[in, optional] error

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

返回值

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

返回代码	说明
E_INVALIDARG	一个或多个参数无效。
WS_E_INVALID_FORMAT	输入数据的格式不是预期的，或者没有预期的值。

注解

• 如果前缀为 NULL，则命名空间不得为 NULL。 在这种情况下，编写器将尝试在范围内查找绑定到指定命名空间的前缀。 如果找到适当的前缀，则将使用该前缀。 如果没有，编写器将生成前缀并在当前元素上插入 XMLNS 属性。 如果编写器不在元素中，则该函数将返回 WS_E_INVALID_FORMAT。

  (请参阅 Windows Web Services 返回值。)

• 如果前缀不为 NULL 且命名空间不为 NULL ，则编写器将验证前缀当前是否绑定到指定的命名空间，否则将返回 WS_E_INVALID_FORMAT 。
• 如果前缀不为 NULL 且命名空间为 NULL ，则编写器将使用前缀和本地名称来写入限定名称。

要求

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