Fonction WinHttpWebSocketCompleteUpgrade (winhttp.h)

Article
27/08/2023

La fonction WinHttpWebSocketCompleteUpgrade termine une négociation WebSocket démarrée par WinHttpSendRequest.

Syntaxe

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

Paramètres

[in] hRequest

Type : HINTERNET

Handle de requête HTTP utilisé pour envoyer une liaison WebSocket.

[in, optional] pContext

Type : DWORD_PTR

Contexte à associer au nouveau handle.

Valeur retournée

Type : HINTERNET

Nouveau handle WebSocket. Si la valeur est NULL, appelez GetLastError pour déterminer la cause de l’échec.

Remarques

WinHttpWebSocketCompleteUpgrade peut être appelé sur une requête HTTP ouverte pour obtenir un handle WebSocket pour effectuer d’autres opérations WebSocket.

Le handle de requête doit être marqué comme une mise à niveau WebSocket en appelant WinHttpSetOption avec WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET avant d’envoyer la demande.

L’appelant doit case activée le code de status HTTP retourné par le serveur et appeler cette fonction uniquement si le code status est 101. L’appel avec n’importe quel autre code status entraîne un échec.

Configuration requise


Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winhttp.h
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll

Partager via