API de componente do protocolo WebSocket

  • Artigo

Finalidade

A API de Componente do Protocolo WebSocket permite canais de comunicação bidirecionais assíncronos por HTTP que funcionam entre intermediários de rede existentes. Com a API de Componente do Protocolo WebSocket, um cliente usa HTTP para se comunicar com um servidor e, em seguida, ambos os lados alternam para o uso do protocolo subjacente no qual HTTP estava em camadas (como TCP ou SSL). A meta é primeiro usar HTTP para percorrer intermediários de rede e, em seguida, usar o canal TCP/SSL subjacente de ponta a ponta estabelecido para comunicação bidirecional do aplicativo. O protocolo WebSocket [WSPROTO] é definido no IETF, enquanto uma API Javascript associada (WebSockets) é definida no WHATWG.

Nesta seção

Tópico Descrição
Tipos de dados da API do componente de protocolo WebSocket
 A API de Componente do Protocolo WebSocket define esses tipos de dados.
Enumerações da API de Componente do Protocolo WebSocket
 A API de Componente do Protocolo WebSocket define essas enumerações.
Funções de API de componente do protocolo WebSocket
 A API de Componente do Protocolo WebSocket define essas funções.
Estruturas de API de componente do protocolo WebSocket
 A API de Componente do Protocolo WebSocket define essas estruturas.

Público de desenvolvedores

A API de Componente do Protocolo WebSocket foi projetada para uso por programadores C/C++. Familiaridade com a rede HTTP e Windows é necessária.

Observação

A maneira preferencial de usar o protocolo WebSocket no Windows é por meio da API dos Serviços HTTP do Windows (WinHTTP) ou do namespace Windows.Networking.Sockets.

Requisitos de tempo de execução

A API de Componente do Protocolo WebSocket requer Windows 8 e versões posteriores do sistema operacional Windows. As APIs podem ser vinculadas dinamicamente por meio de websocket.dll.

Observação

websocket.dll fornece suporte para cabeçalhos HTTP relacionados ao handshake do cliente e do servidor, verifica os dados de handshake recebidos e analisa o fluxo de dados do WebSocket. Ele não lida com operações específicas de HTTP (redirecionamento, autenticação, suporte a proxy) nem executa operações de E/S (enviando ou recebendo bytes de fluxo do WebSocket).

HTTP

Serviços HTTP do Windows (WinHTTP)