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 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 一或多個引數無效。

備註

當訊息重設時，其基礎堆積會重設。

重複使用訊息物件來接收或傳送多個訊息通常比為每個訊息建立和釋放訊息物件更有效率。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll