WebSocket-Protokollkomponenten-API

  • Artikel

Zweck

Die WebSocket-Protokollkomponenten-API ermöglicht asynchrone, bidirektionale Kommunikationskanäle über HTTP, die über vorhandene Netzwerkintermediäre hinweg funktionieren. Mit der WebSocket-Protokollkomponenten-API verwendet ein Client HTTP für die Kommunikation mit einem Server, und dann wechseln beide Seiten zur Verwendung des zugrunde liegenden Protokolls, auf dem HTTP übertragen wurde (z. B. TCP oder SSL). Das Ziel besteht darin, zunächst HTTP zu verwenden, um Netzwerkintermediäre zu durchlaufen, und dann den etablierten, zugrunde liegenden TCP/SSL-Kanal für die bidirektionale Anwendungskommunikation zu verwenden. Das WebSocket-Protokoll [WSPROTO] wird in der IETF definiert, während eine zugeordnete Javascript-API (WebSockets) im WHATWG definiert ist.

In diesem Abschnitt

Thema Beschreibung
WebSocket-Protokollkomponenten-API-Datentypen
 Die WebSocket-Protokollkomponenten-API definiert diese Datentypen.
Api-Enumerationen der WebSocket-Protokollkomponente
 Die WebSocket-Protokollkomponenten-API definiert diese Enumerationen.
API-Funktionen der WebSocket-Protokollkomponente
 Die WebSocket-Protokollkomponenten-API definiert diese Funktionen.
API-Strukturen der WebSocket-Protokollkomponente
 Die WebSocket-Protokollkomponenten-API definiert diese Strukturen.

Entwicklergruppe

Die WebSocket-Protokollkomponenten-API ist für die Verwendung durch C/C++-Programmierer konzipiert. Vertrautheit mit HTTP- und Windows-Netzwerken ist erforderlich.

Hinweis

Die bevorzugte Methode für die Verwendung des WebSocket-Protokolls unter Windows ist die Windows HTTP Services (WinHTTP)-API oder der Windows.Networking.Sockets-Namespace.

Laufzeitanforderungen

Die WebSocket-Protokollkomponenten-API erfordert Windows 8 und höhere Versionen des Windows-Betriebssystems. Die APIs können dynamisch über websocket.dll verknüpft werden.

Hinweis

websocket.dll unterstützt Client- und Server-Handshake-bezogene HTTP-Header, überprüft empfangene Handshakedaten und analysiert den WebSocket-Datenstrom. Es verarbeitet keine HTTP-spezifischen Vorgänge (Umleitung, Authentifizierung, Proxyunterstützung) und führt keine E/A-Vorgänge (Senden oder Empfangen von WebSocket-Streambytes) aus.

HTTP

Windows-HTTP-Dienste (WinHTTP)