API компонента протокола WebSocket

Назначение

API компонента протокола WebSocket обеспечивает асинхронные двунаправленные каналы связи по протоколу HTTP, которые работают между существующими сетевыми посредниками. При использовании API компонента протокола WebSocket клиент использует ПРОТОКОЛ HTTP для связи с сервером, а затем обе стороны переключаются на использование базового протокола, по которому был наложен протокол HTTP (например, TCP или SSL). Цель состоит в том, чтобы сначала использовать HTTP для обхода сетевых посредников, а затем использовать установленный сквозной базовый канал TCP/SSL для двунаправленного взаимодействия с приложениями. Протокол WebSocket [WSPROTO] определяется в IETF, а связанный API JavaScript (WebSockets) — в WHATWG.

В этом разделе

Раздел Описание
Типы данных API компонента протокола WebSocket
Api компонента протокола WebSocket определяет эти типы данных.
Перечисления API компонента протокола WebSocket
Api компонента протокола WebSocket определяет эти перечисления.
Функции API компонента протокола WebSocket
Эти функции определяются в API компонента протокола WebSocket.
Структуры API компонентов протокола WebSocket
Эти структуры определяются с помощью API компонента протокола WebSocket.

Аудитория разработчиков

API компонента протокола WebSocket предназначен для использования программистами C/C++. Требуется знание сетевых подключений HTTP и Windows.

Примечание

Предпочтительный способ использования протокола WebSocket в Windows — использовать API служб Windows HTTP (WinHTTP) или пространство имен Windows.Networking.Sockets.

Требования к среде выполнения

API компонента протокола WebSocket требует Windows 8 и более поздних версий операционной системы Windows. Api можно динамически связать с помощью websocket.dll.

Примечание

websocket.dll обеспечивает поддержку http-заголовков, связанных с подтверждением клиента и сервера, проверяет полученные данные подтверждения и анализирует поток данных WebSocket. Он не обрабатывает операции, относящиеся к HTTP (перенаправление, проверка подлинности, поддержка прокси-сервера), а также не выполняет операции ввода-вывода (отправка или получение байтов потока WebSocket).

HTTP

Службы Windows HTTP (WinHTTP)