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
一个或多个参数无效。

注解

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

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

要求

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