WsWriteXmlnsAttribute 函数 (webservices.h)

将 Xmlns 属性写入当前元素。 必须先调用 WsWriteStartElement,然后才能写入特性,如果属性数超过编写器允许的最大属性数,函数将返回WS_E_QUOTA_EXCEEDED。 (请参阅 Windows Web Services 返回值。)

语法

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

参数

[in] writer

指向要向其写入 Xmlns 属性 的 WS_XML_WRITER 对象的指针。 指针必须引用有效的 XML 编写器 对象。

[in, optional] prefix

指向要用于 start 元素的前缀的WS_XML_STRING指针。 如果此参数引用的值为 NULL ,则编写器将选择一个属性。

指定要用于 xmlns 属性的前缀。

[in] ns

指向要绑定到前缀的命名空间的WS_XML_STRING指针。

[in] singleQuote

确定是对属性值使用单引号还是双引号。

注意 如果设置了 WS_XML_WRITER_BINARY_ENCODING ,则不保留引号字符,并且此参数不起作用。

 

[in, optional] error

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

返回值

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

返回代码 说明
E_INVALIDARG
一个或多个参数无效。
WS_E_INVALID_OPERATION
由于 对象的当前状态,不允许此操作。
WS_E_INVALID_FORMAT
输入数据的格式不是预期的,或者没有预期的值。
WS_E_QUOTA_EXCEEDED
超出配额。

注解

下列条件适用:

  • 如果指定了空前缀,则分配默认命名空间。
  • 如果指定 了 NULL 前缀,则编写器会为命名空间选择适当的前缀。
  • 如果 Xmlns 属性是冗余的,则无法写入该属性。
  • 如果使用空命名空间指定了非空前缀 ,则返回WS_E_INVALID_FORMAT

要求

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