Dela via


Api för WebSocket Protocol-komponent

Avsikt

WebSocket Protocol Component API möjliggör asynkrona, dubbelriktade kommunikationskanaler via HTTP som fungerar mellan befintliga nätverksförmedlare. Med WebSocket Protocol Component API använder en klient HTTP för att kommunicera med en server, och sedan växlar båda sidor till att använda det underliggande protokollet som HTTP var skiktat på (till exempel TCP eller SSL). Målet är att först använda HTTP för att gå över nätverksförmedlare och sedan använda den etablerade underliggande TCP/SSL-kanalen för dubbelriktad programkommunikation. WebSocket-protokollet [WSPROTO] definieras i IETF, medan ett associerat Javascript-API (WebSockets) definieras i WHATWG.

I det här avsnittet

Ämne Beskrivning
WebSocket Protocol-komponentens API-datatyper
WebSocket Protocol Component API definierar dessa datatyper.
WebSocket Protocol Component API-uppräkningar
WebSocket Protocol Component API definierar dessa uppräkningar.
WebSocket Protocol Component API Functions
WebSocket Protocol Component API definierar dessa funktioner.
WebSocket Protocol Component API Structures
WebSocket Protocol Component API definierar dessa strukturer.

Målgrupp för utvecklare

WebSocket Protocol Component API är utformat för användning av C/C++-programmerare. Kunskaper om HTTP- och Windows-nätverk krävs.

Not

Det bästa sättet att använda WebSocket-protokollet i Windows är via api:et Windows HTTP Services (WinHTTP) eller Windows.Networking.Sockets-namnområdet.

Körningskrav

WebSocket Protocol Component API kräver Windows 8 och senare versioner av Windows-operativsystemet. API:erna kan länkas dynamiskt via websocket.dll.

Not

websocket.dll ger stöd för klient- och serverhandskakningsrelaterade HTTP-huvuden, verifierar mottagna handskakningsdata och parsar WebSocket-dataströmmen. Den hanterar inte några HTTP-specifika åtgärder (omdirigering, autentisering, proxysupport) eller utför några I/O-åtgärder (skickar eller tar emot WebSocket-strömbyte).

HTTP-

Windows HTTP Services (WinHTTP)