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 对象的指针,如果函数失败,应存储有关错误的其他信息。
返回值
此函数可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
一个或多个参数无效。 |
|
由于 对象的当前状态,不允许此操作。 |
|
输入数据的格式不是预期的,或者没有预期的值。 |
|
超出配额。 |
注解
下列条件适用:
- 如果指定了空前缀,则分配默认命名空间。
- 如果指定 了 NULL 前缀,则编写器会为命名空间选择适当的前缀。
- 如果 Xmlns 属性是冗余的,则无法写入该属性。
- 如果使用空命名空间指定了非空前缀 ,则返回WS_E_INVALID_FORMAT 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | webservices.h |
Library | WebServices.lib |
DLL | WebServices.dll |