Share via

WsCreateMessage 函数 (webservices.h)

  • 项目

创建具有指定属性 的消息 对象。

语法

HRESULT WsCreateMessage(
  [in]           WS_ENVELOPE_VERSION       envelopeVersion,
  [in]           WS_ADDRESSING_VERSION     addressingVersion,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

参数

[in] envelopeVersion

一个 WS_ENVELOPE_VERSION 枚举值，该值指定邮件的信封版本。

[in] addressingVersion

一个WS_ADDRESSING_VERSION，指定消息的寻址版本。

properties

消息的可选属性数组。 请参阅 WS_MESSAGE_PROPERTY。

此参数的值可以为 NULL，在这种情况下， propertyCount 参数必须为 0 (零) 。

[in] propertyCount

属性数组中的 属性 数。

message

成功时，一个指针，用于接收表示新消息 的 WS_MESSAGE 结构的地址。

如果不再需要此结构，则必须通过调用 WsFreeMessage 将其释放。

[in, optional] error

指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。

返回值

如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。

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

注解

消息对象是 Windows Web 服务的传递工具。 单个消息对象可用于发送或接收顺序消息。 以这种方式重用消息对象可以减少内存分配。 如果不再需要该消息，则必须通过调用 WsFreeMessage 释放内存。 (有关重用消息对象的详细信息，请参阅 WsResetMessage .)

如果要创建用于特定通道的消息，请使用 WsCreateMessageForChannel 函数，这将确保通道的消息版本正确。

要求

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