API de componente do protocolo WebSocket
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).