Fungsi WinHttpWebSocketCompleteUpgrade (winhttp.h)

Artikel
08/27/2023

Fungsi WinHttpWebSocketCompleteUpgrade menyelesaikan jabat tangan WebSocket yang dimulai oleh WinHttpSendRequest.

Sintaks

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

Parameter

[in] hRequest

Jenis: HINTERNET

Handel permintaan HTTP digunakan untuk mengirim jabat tangan WebSocket.

[in, optional] pContext

Jenis: DWORD_PTR

Konteks yang akan dikaitkan dengan handel baru.

Nilai kembali

Jenis: HINTERNET

Handel WebSocket baru. Jika NULL, panggil GetLastError untuk menentukan penyebab kegagalan.

Keterangan

WinHttpWebSocketCompleteUpgrade dapat dipanggil pada permintaan HTTP terbuka untuk mendapatkan handel WebSocket untuk melakukan operasi WebSocket lainnya.

Handel permintaan harus ditandai sebagai pemutakhiran WebSocket dengan memanggil WinHttpSetOption dengan WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET sebelum mengirim permintaan.

Pemanggil harus memeriksa kode status HTTP yang dikembalikan oleh server dan memanggil fungsi ini hanya jika kode status adalah 101. Memanggilnya dengan kode status lainnya akan mengakibatkan kegagalan.

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	winhttp.h
Pustaka	Winhttp.lib
DLL	Winhttp.dll

Bagikan melalui