WsResetChannel 函式 (webservices.h)

重設通道,以便重複使用。

語法

HRESULT WsResetChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

參數

[in] channel

要重設的通道。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

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

傳回碼 Description
WS_E_INVALID_OPERATION
通道處於不適當的狀態。

備註

重複使用通道,而不是從頭建立通道,可能會改善效能。

只有在通道處於 WS_CHANNEL_STATE_CREATEDWS_CHANNEL_STATE_CLOSED 狀態時,此函式才有效。

如果正確呼叫,則此函式不會失敗 (例如,因為缺少系統資源) 。

規格需求

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