Funzione WinHttpWebSocketCompleteUpgrade (winhttp.h)

Articolo
03/15/2023

La funzione WinHttpWebSocketCompleteUpgrade completa un handshake WebSocket avviato da WinHttpSendRequest.

Sintassi

WINHTTPAPI HINTERNET WinHttpWebSocketCompleteUpgrade(
  [in]           HINTERNET hRequest,
  [in, optional] DWORD_PTR pContext
);

Parametri

[in] hRequest

Tipo: SUBNETNET

Handle di richiesta HTTP usato per inviare un handshake WebSocket.

[in, optional] pContext

Tipo: DWORD_PTR

Contesto da associare al nuovo handle.

Valore restituito

Tipo: SUBNETNET

Nuovo handle WebSocket. Se NULL, chiamare GetLastError per determinare la causa dell'errore.

Commenti

WinHttpWebSocketCompleteUpgrade può essere chiamato su una richiesta HTTP aperta per ottenere un handle WebSocket per eseguire altre operazioni WebSocket.

L'handle di richiesta deve essere contrassegnato come aggiornamento WebSocket chiamando WinHttpSetOption con WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET prima di inviare la richiesta.

Il chiamante deve controllare il codice di stato HTTP restituito dal server e chiamare questa funzione solo se il codice di stato è 101. La chiamata con qualsiasi altro codice di stato comporterà un errore.

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winhttp.h
Libreria	Winhttp.lib
DLL	Winhttp.dll

Condividi tramite