CAsyncSocket::criar

Artigo
08/25/2010

telefonar the Criarfunção de membro após a construção de um objeto de soquete para criar o soquete do Windows e anexá-lo.

BOOL Create(
   UINT nSocketPort = 0,
   int nSocketType = SOCK_STREAM,
   long lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE,
   LPCTSTR lpszSocketAddress = NULL 
);

Parâmetros

nSocketPort
Uma porta a ser usado com o soquete ou 0 se desejar que o Windows Sockets para selecionar uma porta conhecida.
nSocketType
SOCK_STREAM or SOCK_DGRAM.
lEvent
Uma máscara de bits que especifica uma combinação de eventos de rede em que o aplicativo está interessado.
- FD_READ Deseja receber notificação de prontidão para leitura.
- FD_WRITE Deseja receber notificação de prontidão para gravação.
- FD_OOB Deseja receber notificação de chegada de dados fora de banda.
- FD_ACCEPT Deseja receber notificação de conexões de entrada.
- FD_CONNECT Deseja receber notificação de conexão completada.
- FD_CLOSE Deseja receber notificação de fechamento de soquete.
lpszSockAddress
Um ponteiro para uma seqüência de caracteres que contém o endereço de rede do soquete conectado, um número pontilhado, sistema autônomo "128.56.22.8".Passing oNULO a seqüência de caracteres para este parâmetro indica o CAsyncSocket instância deve monitorar atividade do cliente em todas sistema autônomo interfaces de rede.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0, e um código de erro específico pode ser recuperado chamando GetLastError.Os seguintes erros se aplicam a essa função de membro:

WSANOTINITIALISED Um bem-sucedida AfxSocketInit deve ocorrer antes de usar essa API.
WSAENETDOWN A implementação do Windows Sockets detectou que o subsistema de rede falhou.
WSAEAFNOSUPPORT Especificado endereço família não é suportada.
WSAEINPROGRESS Uma operação de bloqueio de Windows Sockets está em andamento.
WSAEMFILE Não há mais descritores de arquivo estão disponível.
WSAENOBUFS Nenhum espaço do buffer está disponível. Não é possível criar o soquete.
WSAEPROTONOSUPPORT Não há suporte para a porta especificada.
WSAEPROTOTYPE A porta especificada é o tipo errado para esse soquete.
WSAESOCKTNOSUPPORT Não há suporte para o tipo de soquete especificado neste endereço família.

Comentários

Criar calls Soquete e se for bem-sucedido, ele chama BIND BIND o soquete para o endereço especificado.Há suporte para os seguintes tipos de soquete:

SOCK_STREAM Fornece fluxos seqüenciada confiável, full-duplex, conexão e baseada em byte.Usa o TCP (protocolo TCP) para o endereço na Internet família.

SOCK_DGRAM Aceita datagramas, que são os pacotes sem conexão e não confiáveis de um comprimento máximo fixo (normalmente pequeno).Usa o UDP (protocolo UDP) para a família de endereços de Internet.

Observação:
O Aceitar função de membro leva uma referência a um novo e vazio CSocket objeto sistema autônomo parâmetro. Você deve construir esse objeto antes de você telefonar Aceitar.Tenha em mente que, se esse objeto de soquete sai do escopo, fecha a conexão.Não chame Criar para esse novo objeto de soquete.