Delen via


WebSocket Protocol Component-API

Doel

De WebSocket Protocol Component-API maakt asynchrone, bidirectionele communicatiekanalen mogelijk via HTTP die werken tussen bestaande netwerktussenpersonen. Met de WebSocket Protocol Component-API gebruikt een client HTTP om te communiceren met een server en vervolgens schakelen beide zijden over naar het onderliggende protocol waarop HTTP is gelaagd (zoals TCP of SSL). Het doel is om eerst HTTP te gebruiken om via netwerktussenpersonen te gaan en vervolgens het gevestigde end-to-end onderliggende TCP/SSL-kanaal te gebruiken voor bidirectionele toepassingscommunicatie. Het WebSocket-protocol [WSPROTO] wordt gedefinieerd op de IETF, terwijl een bijbehorende Javascript-API (WebSockets) wordt gedefinieerd in de WHATWG.

In deze sectie

Onderwerp Beschrijving
Api-gegevenstypen voor websocket-protocolonderdelen
De WebSocket Protocol Component-API definieert deze gegevenstypen.
API-opsommingen voor websocket-onderdelen
De WebSocket Protocol Component-API definieert deze opsommingen.
API-functies voor WebSocket-protocolonderdelen
De WebSocket Protocol Component-API definieert deze functies.
Api-structuren voor websocket-protocolonderdelen
De WebSocket Protocol Component-API definieert deze structuren.

Doelgroep voor ontwikkelaars

De WebSocket Protocol Component-API is ontworpen voor gebruik door C/C++ programmeurs. Bekendheid met HTTP- en Windows-netwerken is vereist.

Notitie

De voorkeursmethode voor het gebruik van het WebSocket-protocol in Windows is via de Windows HTTP Services-API (WinHTTP) of de Windows.Networking.Sockets-naamruimte.

Runtimevereisten

Voor de WebSocket Protocol Component-API is Windows 8 en latere versies van het Windows-besturingssysteem vereist. De API's kunnen dynamisch worden gekoppeld via websocket.dll.

Notitie

websocket.dll biedt ondersteuning voor http-headers die zijn gerelateerd aan client- en server-handshake, verifieert ontvangen handshake-gegevens en parseert de WebSocket-gegevensstroom. Het verwerkt geen HTTP-specifieke bewerkingen (omleiding, verificatie, proxyondersteuning) en voert geen I/O-bewerkingen uit (het verzenden of ontvangen van WebSocket-stroombytes).

HTTP-

Windows HTTP Services (WinHTTP)