WsWriteType 函数 (webservices.h)

  • 项目

根据WS_TYPE_MAPPING将给定WS_TYPE的值写入 XML。

语法

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

参数

[in] writer

要向其写入值的编写器。

[in] typeMapping

描述类型如何映射到正在写入的 XML。

[in] type

要序列化的值的类型。

[in, optional] typeDescription

有关类型的其他信息。 每种类型都有不同的说明结构。 这可能为 NULL，具体取决于 WS_TYPE。

[in] writeOption

该值是否是必需的，以及值的分配方式。 有关详细信息 ，请参阅WS_WRITE_OPTION 。

此参数必须具有以下值之一：

value

指向要序列化的值的指针。

[in] valueSize

要序列化的值的大小。

[in, optional] error

指定在函数失败时应存储其他错误信息的位置。

返回值

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

返回代码 说明
WS_E_INVALID_FORMAT
 输入数据的格式不是预期的，或者没有预期的值。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 内存不足。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

有关如何使用此函数在元素和属性中写入值，请参阅 WS_TYPE_MAPPING 。

如果 API 失败，则输入编写器的状态将变为未定义。 如果发生这种情况，可以在编写器上使用的唯一 API 是 WsSetOutput 和 WsSetOutputToBuffer ，用于将编写器返回到可用状态，或 WsFreeWriter 释放编写器。

要求

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