跳轉到主要內容

HCWebSocketConnectAsync

連線至 WebSocket。

語法

參數

uri   _In_z_
類型:char*
要連線的 UTF-8 編碼 URI。 subProtocol   _In_z_
類型:char*
要連線的 UTF-8 編碼 subProtocol。 websocket   _In_
類型:HCWebsocketHandle
WebSocket 的控制代碼。 asyncBlock   _Inout_
類型:XAsyncBlock*
定義非同步作業的 XAsyncBlock。

傳回值

類型:HRESULT 此 API 作業的結果代碼。可能的值為 S_OK、E_INVALIDARG、E_OUTOFMEMORY 或 E_FAIL。

備註

若要取得結果,請先在 AsyncBlock 回呼內或在 AsyncBlock 完成後呼叫 HCGetWebSocketConnectResult。在 UWP 和 XDK 上,連線執行緒由 Windows::Networking::Sockets::MessageWebSocket 擁有和控制。在 Win32、iOS 和 Android 上,所有背景工作 (包括初始連線程序) 都會新增至所提供之 XAsyncBlock 中的佇列。LibHttpClient 會建立該佇列的參考,但只要 WebSocket 連線處於作用中,呼叫端就有責任分派該佇列。請注意,如有需要,可以將 HCWebSocketSendMessageAsync 呼叫的工作指派給個別的佇列。

需求

標頭: httpClient.h 程式庫: libHttpClient.GDK.lib

另請參閱

httpClient
最後修改於 2026年10月6日