WS_WRITE_TYPE_CALLBACK回调函数 (webservices.h)

调用以在指定 WS_CUSTOM_TYPE 时写入元素。 这允许编写不容易映射到核心序列化模型的 XML 构造。

语法

WS_WRITE_TYPE_CALLBACK WsWriteTypeCallback;

HRESULT WsWriteTypeCallback(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           const void *descriptionData,
                 const void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

参数

[in] writer

指向应写入值的编写器的 WS_XML_WRITER 指针。

[in] typeMapping

指示 XML 如何映射到此类型。 有关详细信息 ，请参阅WS_TYPE_MAPPING 。

如果映射对此特定类型没有意义，则回调应返回 WS_E_INVALID_OPERATION。 (请参阅 Windows Web Services 返回值。) 回调实现应准备好在未来版本中传递新的映射类型，并且应对这些情况返回 WS_E_INVALID_OPERATION 。

[in] descriptionData

这是WS_CUSTOM_TYPE_DESCRIPTION结构的 descriptionData 字段的值。 回调使用此字段来访问有关类型的任何其他信息。

value

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

[in] valueSize

要序列化的值的大小（以字节为单位）。

[in, optional] error

指向 WS_ERROR 数据结构的指针，如果函数失败，应存储其他错误信息。

返回值

此回调函数不返回值。

注解

将在WS_TYPE_MAPPING文档中使用与 WsWriteType 相同的调用序列调用 回调。 这定义了回调应写入的 XML 的哪些部分。

要求

最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	webservices.h