WsResetMessage 函数 (webservices.h)

将消息状态设置回 WS_MESSAGE_STATE_EMPTY。在此状态下，可以重复使用 Message 对象。

语法

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

[in] message

指向要重置的 Message 对象的指针。

[in, optional] error

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

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

返回代码	说明
E_INVALIDARG	一个或多个参数无效。

重置消息时，其基础堆会重置。

通常，重用消息对象来接收或发送多条消息比为每个消息创建和释放消息对象更高效。