Udostępnij za pośrednictwem


Interfejs API składnika protokołu WebSocket

Cel

Interfejs API składnika protokołu WebSocket umożliwia asynchroniczne, dwukierunkowe kanały komunikacyjne za pośrednictwem protokołu HTTP, które działają między istniejącymi pośrednikami sieci. Za pomocą interfejsu API składnika protokołu WebSocket klient używa protokołu HTTP do komunikowania się z serwerem, a następnie obie strony przełączają się na przy użyciu bazowego protokołu HTTP, na który zastosowano warstwę (np. TCP lub SSL). Celem jest najpierw użycie protokołu HTTP do przechodzenia przez pośredników sieciowych, a następnie użycie ustanowionego kompleksowego kanału TCP/SSL na potrzeby komunikacji aplikacji dwukierunkowej. Protokół WebSocket [WSPROTO] jest zdefiniowany w pliku IETF, podczas gdy skojarzony interfejs API języka JavaScript (WebSockets) jest definiowany w usłudze WHATWG.

W tej sekcji

Temat Opis
typy danych interfejsu API składników protokołu WebSocket
Interfejs API składnika protokołu WebSocket definiuje te typy danych.
wyliczenia interfejsu API składników protokołu WebSocket
Interfejs API składnika protokołu WebSocket definiuje te wyliczenia.
funkcje interfejsu API protokołu WebSocket
Interfejs API składnika protokołu WebSocket definiuje te funkcje.
struktury interfejsu API składników protokołu WebSocket
Interfejs API składnika protokołu WebSocket definiuje te struktury.

Odbiorcy deweloperów

Interfejs API składnika protokołu WebSocket jest przeznaczony do użytku przez programistów języka C/C++. Wymagana jest znajomość protokołu HTTP i sieci systemu Windows.

Nuta

Preferowanym sposobem korzystania z protokołu WebSocket w systemie Windows jest użycie interfejsu API windows HTTP (WinHTTP) lub przestrzeni nazw Windows.Networking.Sockets.

Wymagania dotyczące czasu wykonywania

Interfejs API składnika protokołu WebSocket wymaga systemu Windows 8 i nowszych wersji systemu operacyjnego Windows. Interfejsy API mogą być dynamicznie połączone za pośrednictwem websocket.dll.

Nuta

websocket.dll zapewnia obsługę nagłówków HTTP związanych z uzgadnianiami klienta i serwera, weryfikuje odebrane dane uzgadniania i analizuje strumień danych protokołu WebSocket. Nie obsługuje żadnych operacji specyficznych dla protokołu HTTP (przekierowywanie, uwierzytelnianie, obsługa serwera proxy) ani wykonywanie żadnych operacji we/wy (wysyłanie lub odbieranie bajtów strumienia protokołu WebSocket).

HTTP

usług HTTP systemu Windows (WinHTTP)