Canal (Windows Web Services)
Os canais encapsulam um contexto de comunicação entre duas ou mais partes e são usados para enviar e receber mensagens.
No cliente, use WsCreateChannel para criar um canal. No servidor, use WsCreateChannelForListener para criar um canal que possa ser aceito pelo cliente usando um ouvinte.
Ao criar um canal, você especifica as informações a seguir, que determinam o comportamento local do canal e o protocolo de transmissão a ser usado.
- Um WS_CHANNEL_TYPE, que identifica o padrão de troca de mensagens do canal.
- Um WS_CHANNEL_BINDING, que identifica o protocolo de transferência a ser usado.
- Um WS_SECURITY_DESCRIPTION, que especifica a segurança usada para o canal. Ao criar canais para uso em um servidor, isso é especificado uma vez para todos os canais que serão aceitos para um determinado ouvinte.
- Um conjunto WS_CHANNEL_PROPERTYs, que especificam configurações opcionais adicionais (para obter uma lista dessas configurações, consulte as enumerações WS_CHANNEL_PROPERTY_ID ).
Antes de usar o canal, você deve abri-lo chamando a função WsOpenChannel e especificando o canal e o endereço do ponto de extremidade, juntamente com outras informações opcionais.
Para obter informações sobre as transições de estado para um canal, consulte o tópico Estados do Canal .
Para obter mais informações sobre canais, consulte o tópico Visão geral da camada de canal .
Os seguintes elementos de API são usados com canais.
| Callback | Descrição |
|---|---|
| WS_ABANDON_MESSAGE_CALLBACK | Manipula a chamada WsAbandonMessage para um canal com associação de canal personalizada. |
| WS_ABORT_CHANNEL_CALLBACK | Manipula a chamada WsAbortChannel para um canal com associação de canal personalizada. |
| WS_CLOSE_CHANNEL_CALLBACK | Manipula a chamada WsCloseChannel para um canal com associação de canal personalizada. |
| WS_CREATE_CHANNEL_CALLBACK | Manipula a chamada WsCloseChannel para um canal com associação de canal personalizada. |
| WS_CREATE_DECODER_CALLBACK | Manipula a criação de uma instância de decodificador. |
| WS_CREATE_ENCODER_CALLBACK | Manipula a criação de uma instância do codificador. |
| WS_DECODER_DECODE_CALLBACK | Decodifica uma mensagem. |
| WS_DECODER_END_CALLBACK | Decodifica o final de uma mensagem. |
| WS_DECODER_GET_CONTENT_TYPE_CALLBACK | Obtém o tipo de conteúdo da mensagem. |
| WS_DECODER_START_CALLBACK | Inicia a decodificação de uma mensagem. |
| WS_ENCODER_ENCODE_CALLBACK | Codifica uma mensagem. |
| WS_ENCODER_END_CALLBACK | Codifica o final de uma mensagem. |
| WS_ENCODER_GET_CONTENT_TYPE_CALLBACK | Obtém o tipo de conteúdo da mensagem. |
| WS_ENCODER_START_CALLBACK | Inicia a codificação de uma mensagem. |
| WS_FREE_CHANNEL_CALLBACK | Manipula a chamada WsFreeChannel para um canal com associação de canal personalizada. |
| WS_FREE_DECODER_CALLBACK | Manipula a liberação de uma instância de decodificador. |
| WS_FREE_ENCODER_CALLBACK | Manipula a liberação de uma instância do codificador. |
| WS_GET_CHANNEL_PROPERTY_CALLBACK | Manipula a chamada WsGetChannelProperty para um canal com associação de canal personalizada. |
| WS_HTTP_REDIRECT_CALLBACK | Invocado quando uma mensagem está prestes a ser redirecionada automaticamente para outro serviço utilizando a funcionalidade de redirecionamento automático HTTP, conforme descrito em RFC2616. |
| WS_OPEN_CHANNEL_CALLBACK | Manipula a chamada WsOpenChannel para um canal com associação de canal personalizada. |
| WS_READ_MESSAGE_END_CALLBACK | Manipula a chamada WsReadMessageEnd para um canal com associação de canal personalizado. |
| WS_READ_MESSAGE_START_CALLBACK | Manipula a chamada WsReadMessageEnd para um canal com associação de canal personalizado. |
| WS_RESET_CHANNEL_CALLBACK | Manipula a chamada WsResetChannel para um canal com associação de canal personalizada. |
| WS_SET_CHANNEL_PROPERTY_CALLBACK | Manipula a chamada WsSetChannelProperty para um canal com associação de canal personalizada. |
| WS_SHUTDOWN_SESSION_CHANNEL_CALLBACK | Manipula a chamada WsShutdownSessionChannel para um canal com associação de canal personalizado. |
| WS_WRITE_MESSAGE_END_CALLBACK | Manipula a chamada WsWriteMessageEnd para um canal com associação de canal personalizada. |
| WS_WRITE_MESSAGE_START_CALLBACK | Manipula a chamada WsWriteMessageStart para um canal com associação de canal personalizada. |
| Enumeração | Descrição |
|---|---|
| WS_CHANNEL_BINDING | Indica a pilha de protocolo a ser usada para o canal. |
| WS_CHANNEL_PROPERTY_ID | Identifica cada propriedade de canal por uma ID. |
| WS_CHANNEL_STATE | O estado do canal. |
| WS_CHANNEL_TYPE | Indica as características básicas do canal, como se ele tem sessão e quais direções de comunicação têm suporte. |
| WS_ENCODING | As diferentes codificações (formatos de mensagem). |
| WS_RECEIVE_OPTION | Especifica se uma mensagem é necessária ao receber de um canal. |
| WS_TRANSFER_MODE | Especifica se as mensagens enviadas ou recebidas são transmitidas ou armazenadas em buffer. |
| Função | Descrição |
|---|---|
| WsAbandonMessage | Ignora o restante de uma mensagem para um canal. |
| WsAbortChannel | Anula todas as E/S pendentes em um canal especificado e define o estado do canal como WS_CHANNEL_STATE_FAULTED. |
| WsCloseChannel | Fecha um canal quando ele não é mais necessário. |
| WsCreateChannel | Cria um canal. |
| WsCreateChannelForListener | Cria um canal para um ouvinte. |
| WsFreeChannel | Libera os recursos de memória associados a um canal. |
| WsGetChannelProperty | Recupera uma propriedade do Canal referenciado pelo parâmetro channel. |
| WsOpenChannel | Abre um canal para um ponto de extremidade. |
| WsReadMessageEnd | Lê os elementos de fechamento de uma mensagem de um canal. |
| WsReadMessageStart | Lê os cabeçalhos da próxima mensagem do canal e se prepara para ler os elementos do corpo. |
| WsReceiveMessage | Recebe uma mensagem e desserializa o corpo da mensagem como um valor. |
| WsRequestReply | Envia uma mensagem de solicitação e recebe uma mensagem de resposta correlacionada. |
| WsResetChannel | Redefina um canal para que ele possa ser reutilizado. |
| WsSendMessage | Envia uma mensagem em um canal usando serialização para gravar o elemento body. |
| WsSendReplyMessage | Envia uma mensagem que é uma resposta a uma mensagem recebida. |
| WsSetChannelProperty | Define uma propriedade de um canal. |
| WsSetMessageProperty | Define uma propriedade de uma mensagem. |
| WsWriteMessageEnd | Grava os elementos de fechamento de uma mensagem no canal. |
| WsWriteMessageStart | Escreva os cabeçalhos de uma mensagem no canal e prepare-se para gravar os elementos do corpo. |
| Handle | Descrição |
|---|---|
| WS_CHANNEL | Um tipo opaco usado para referenciar um canal. |
| Estrutura | Descrição |
|---|---|
| WS_CHANNEL_DECODER | Um conjunto de retornos de chamada que transformam o tipo de conteúdo e os bytes codificados de uma mensagem recebida. |
| WS_CHANNEL_ENCODER | Um conjunto de retornos de chamada que podem transformar o tipo de conteúdo e bytes codificados de uma mensagem enviada. |
| WS_CHANNEL_PROPERTIES | Um conjunto de estruturas WS_CHANNEL_PROPERTY . |
| WS_CHANNEL_PROPERTY | Uma configuração específica do canal. |
| WS_CUSTOM_CHANNEL_CALLBACKS | Um conjunto de retornos de chamada que formam a implementação de um canal personalizado. |
| WS_CUSTOM_HTTP_PROXY | usado para especificar o proxy personalizado para o canal, usando o valor WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY da enumeração WS_CHANNEL_PROPERTY_ID . |
| WS_HTTP_HEADER_MAPPING | Representa um cabeçalho individual mapeado como parte de WS_HTTP_MESSAGE_MAPPING. |
| WS_HTTP_MESSAGE_MAPPING | Informações sobre como uma solicitação OU resposta HTTP deve ser representada em um objeto de mensagem. |
| WS_HTTP_REDIRECT_CALLBACK_CONTEXT | Especifica a função de retorno de chamada e o estado para controlar o comportamento de redirecionamento automático HTTP. |
| WS_MESSAGE_DESCRIPTION | O esquema do WS_MESSAGE de entrada e saída para uma determinada descrição da operação. |