WsInitializeMessage 函数 (webservices.h)

  • 项目

此函数初始化消息的标头，以便为处理做准备。 初始化消息后，应用程序可以添加其他标头。 成功后，消息处于 WS_MESSAGE_STATE_INITIALIZED 状态。 如果函数失败，则不会发生状态转换。

语法

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

参数

[in] message

指向要初始化的 Message 对象的指针。 Message 必须是由 WsCreateMessage 或 WsCreateMessageForChannel 返回的有效WS_MESSAGE对象实例，并且不能为 NULL。

[in] initialization

定义消息初始化。

注意 如果 初始化 值设置为 WS_REPLY_MESSAGE 或 WS_FAULT_MESSAGE 则消息会自动寻址。
 

[in, optional] sourceMessage

指向用于初始化 message 参数的消息 对象的指针。 此值应为 NULL，除非初始化参数的值为 WS_DUPLICATE_MESSAGE、 WS_REPLY_MESSAGE 或 WS_FAULT_MESSAGE。

[in, optional] error

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

返回值

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

返回代码 说明
E_OUTOFMEMORY
 内存不足。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

邮件的初始发送方应使用 WsSetHeader 向邮件添加操作标头。

在为消息调用 WsWriteEnvelopeStart 或 WsWriteMessageStart 之前，必须调用此 API。

要求

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