WsAddressMessage 函数 (webservices.h)

  • 项目

将 消息 寻址到指定的 终结点地址。

语法

HRESULT WsAddressMessage(
  [in]           WS_MESSAGE                *message,
  [in, optional] const WS_ENDPOINT_ADDRESS *address,
  [in, optional] WS_ERROR                  *error
);

参数

[in] message

指向表示要寻址的消息 的WS_MESSAGE 结构的指针。

[in, optional] address

指向 WS_ENDPOINT_ADDRESS 结构的指针，该结构包含要向其寻址消息的终结点。

注意 将 NULL 传递给此参数表示未向消息添加任何标头。 这提供了一种将 WS_MESSAGE_PROPERTY_ID 设置为 WS_MESSAGE_PROPERTY_IS_ADDRESSED 的方法，而无需修改消息中的标头集。
 

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_OPERATION
 消息已解决。 (WS_MESSAGE_PROPERTY_IS_ADDRESSED 属性指示是否已对消息进行寻址。)
E_INVALIDARG
 一个或多个参数无效。
WS_E_INVALID_FORMAT
 输入数据未采用预期格式或没有预期值。
E_OUTOFMEMORY
 内存不足，无法完成操作。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

如果不通过调用此函数对消息进行寻址，通道会自动使用传递给 WsOpenChannel 的终结点地址对消息进行寻址。

此函数通过将 WS_MESSAGE_PROPERTY_IS_ADDRESSED 属性设置为 TRUE 将消息标记为已寻址。

如果消息已处理并返回 WS_E_INVALID_OPERATION，则此函数将失败。

如果将非 NULLWS_ENDPOINT_ADDRESS 传递给函数，该函数将执行以下附加步骤：

要求

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