Funzione WinHttpWebSocketCompleteUpgrade (winhttp.h)

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