Partilhar via


API do componente de protocolo WebSocket

Finalidade

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

Nesta secção

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

Público de desenvolvedores

A API do componente do protocolo WebSocket foi projetada para ser usada por programadores C/C++. É necessária familiaridade com redes HTTP e Windows.

Observação

A maneira preferida de usar o protocolo WebSocket no Windows é por meio do de API do Windows HTTP Services (WinHTTP) ou do de namespace Windows.Networking.Sockets .

Requisitos de tempo de execução

A API do componente do protocolo WebSocket requer o Windows 8 e versões posteriores do sistema operacional Windows. As APIs podem ser vinculadas dinamicamente por meio 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 WebSocket. Ele não lida com nenhuma operação específica de HTTP (redirecionamento, autenticação, suporte a proxy) nem executa nenhuma operação de E/S (envio ou recebimento de bytes de fluxo WebSocket).

HTTP

do Windows HTTP Services (WinHTTP)