Classe de CAsyncSocket

Artigo
03/26/2013

Representa um soquete do windows — um ponto final de comunicação de rede.

class CAsyncSocket : public CObject

Membros

Construtores public

Nome	Descrição
CAsyncSocket::CAsyncSocket	Constrói um objeto de CAsyncSocket .

Métodos públicos

Nome	Descrição
CAsyncSocket::Accept	Aceita uma conexão em soquete.
CAsyncSocket::AsyncSelect	Solicitar a notificação de eventos para o soquete.
CAsyncSocket::Attach	Anexa um tratador de soquete a um objeto de CAsyncSocket .
CAsyncSocket::Bind	Associa um endereço local com o soquete.
CAsyncSocket::Close	Fecha o soquete.
CAsyncSocket::Connect	Estabelece uma conexão a um soquete de ponto.
CAsyncSocket::Create	Cria um soquete.
CAsyncSocket::Detach	Dispara um identificador de soquete de um objeto de CAsyncSocket .
CAsyncSocket::FromHandle	Retorna um ponteiro para um objeto de CAsyncSocket , dado um identificador de soquete.
CAsyncSocket::GetLastError	Obtém o status de erro para a operação da última que falhou.
CAsyncSocket::GetPeerName	Obtém o endereço de soquete de ponto no qual o soquete está conectado.
CAsyncSocket::GetPeerNameEx	Obtém o endereço de soquete de ponto no qual o soquete está conectado (endereços IPV6 handles).
CAsyncSocket::GetSockName	Obtém o nome local para um soquete.
CAsyncSocket::GetSockNameEx	Obtém o nome local para um soquete endereços IPV6 (handles).
CAsyncSocket::GetSockOpt	Recupera uma opção de soquete.
CAsyncSocket::IOCtl	Controla o modo de soquete.
CAsyncSocket::Listen	Estabelece um soquete para escutar solicitações de conexão de entrada.
CAsyncSocket::Receive	Receber dados de soquete.
CAsyncSocket::ReceiveFrom	Recebe uma datagrama e armazena o endereço de origem.
CAsyncSocket::ReceiveFromEx	Recebe uma datagrama e armazena o endereço de origem (endereços IPV6 handles).
CAsyncSocket::Send	Enviar dados para um soquete conectado.
CAsyncSocket::SendTo	Enviar dados para um destino específico.
CAsyncSocket::SendToEx	Dados de envia a um destino específico (endereços IPV6 handles).
CAsyncSocket::SetSockOpt	Define uma opção de soquete.
CAsyncSocket::ShutDown	As desativa verificação Enviar e/ou Receber chamam um soquete.
CASyncSocket::Socket	Atribui uma alça de soquete.

Métodos protegidos

Nome	Descrição
CAsyncSocket::OnAccept	Notifica um soquete escuta que pode aceitar durante solicitações de conexão chamando Aceitar.
CAsyncSocket::OnClose	Notifica um soquete que o soquete conectado a se ele tiver fechado.
CAsyncSocket::OnConnect	Notifica um soquete conectando a tentativa de conexão estiver concluída, se com êxito ou o erro.
CAsyncSocket::OnOutOfBandData	Notifica um soquete de recepção que os dados fora de banda a ser lido em soquete, geralmente uma mensagem urgente.
CAsyncSocket::OnReceive	Notifica um soquete escuta que os dados a ser recuperado chamando Receber.
CAsyncSocket::OnSend	Notifica um soquete que pode enviar dados chamando Enviar.

Operadores públicos

Nome	Descrição
CAsyncSocket::operator =	Atribuir um novo valor a um objeto de CAsyncSocket .
SOQUETE de CAsyncSocket::operator	Use o operador para recuperar a alça de SOQUETE do objeto de CAsyncSocket .

Membros públicos de dados

Nome	Descrição
CAsyncSocket::m_hSocket	Indica a alça de SOQUETE anexada a esse objeto de CAsyncSocket .

Comentários

A classe CAsyncSocket encapsula as funções da API de soquete do windows, fornecendo uma abstração orientada a objetos para os desenvolvedores que desejam usar os soquetes do windows em conjunto com o MFC.

Essa classe é baseado a suposição que você entende comunicação de rede.Você é responsável para manipular o bloqueio, as diferenças de bytes ordem, e conversões entre cadeias de caracteres Unicode e do conjunto de caracteres de multibyte (MBCS).Se você desejar uma interface mais conveniente que gerencia esses problemas para você, consulte a classe CSocket.

Para usar um objeto de CAsyncSocket , chamar o construtor, para chamar a função de Criar para criar a alça de soquete tipo subjacente ( SOCKET), exceto na aceitos.Para um soquete de servidor chamar a função de membro de escutar , e um soquete de cliente para chamar a função de membro de Conectar .O soquete do servidor deve chamar a função de Aceitar em cima de receber uma solicitação de conexão.Use as funções restantes de CAsyncSocket para realizar comunicação entre os soquetes.Após a conclusão, destrua o objeto de CAsyncSocket se foi criado no heap; o destrutor automaticamente chama a função de Fechar .O tipo de dados de SOCKET é descrito no artigo Soquetes do windows: plano de fundo.

Observação
A o usar os soquetes MFC em segmentos secundários em um aplicativo MFC estaticamente associado, você deve chamar AfxSocketInit em cada segmento que usa os soquetes para inicializar as bibliotecas de soquete.Por padrão, AfxSocketInit é chamado somente no segmento principal.