Поделиться через

Функция WinHttpWebSocketCompleteUpgrade (winhttp.h)

  • Статья

Функция WinHttpWebSocketCompleteUpgrade завершает подтверждение WebSocket, запущенное WinHttpSendRequest.

Синтаксис

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

Параметры

[in] hRequest

Тип: HINTERNET

Дескриптор HTTP-запроса, используемый для отправки подтверждения WebSocket.

[in, optional] pContext

Тип: DWORD_PTR

Контекст, связанный с новым дескриптором.

Возвращаемое значение

Тип: HINTERNET

Новый дескриптор WebSocket. Если значение NULL, вызовите Метод GetLastError , чтобы определить причину сбоя.

Комментарии

WinHttpWebSocketCompleteUpgrade можно вызвать в открытом HTTP-запросе, чтобы получить дескриптор WebSocket для выполнения других операций WebSocket.

Дескриптор запроса должен быть помечен как обновление WebSocket путем вызова WinHttpSetOption с WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET перед отправкой запроса.

Вызывающий объект должен проверка код состояния HTTP, возвращенный сервером, и вызывать эту функцию, только если код состояния был 101. Вызов с любым другим кодом состояния приведет к сбою.

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winhttp.h
Библиотека Winhttp.lib
DLL Winhttp.dll