WsWriteValue 函数 (webservices.h)

此操作从基础编码派生基元值的最佳表示形式,并将派生值传递给 Writer 对象。

注意 通常,使用此函数写出基元值,而不是将值转换为文本,然后使用 WsWriteChars 更高效。

 

语法

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

参数

[in] writer

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

[in] valueType

指示 value 参数引用的基元值的类型。

I

value

指向基元值的 void 指针。

[in] valueSize

正在写入的值的大小(以字节为单位)。

[in, optional] error

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

返回值

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

返回代码 说明
E_INVALIDARG
一个或多个参数无效。
WS_E_INVALID_OPERATION
由于对象的当前状态,不允许该操作。

注解

WsWriteValue 只能在 WsWriteStartAttribute 和 WsWriteEndAttribute 之间调用一次。 编写属性时,它不能与 WsWriteCharsWsWriteBytesWsWriteCharsUtf8WsWriteText 结合使用

要求

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