CAsyncSocket::Create

BOOL Criar ( UINT nSocketPort = 0, int nSocketType = SOCK_STREAM, longo lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE, LPCTSTR lpszSocketAddress = Nulo );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0 e um código de erro específicos podem ser recuperadas chamando GetLastError. Os seguintes erros aplicam para esta função de membro:

• WSA&NOTINITIALISEDAnbsp;  Uma bem-sucedida AfxSocketInit deve ocorrer antes de usar essa API.
  
  
• WSAE&NETDOWNnbsp;  A implementação de soquetes do Windows detectou que o subsistema da rede falhou.
  
  
• WSAEAF&NOSUPPORTnbsp;  A família de endereços especificado não é suportada.
  
  
• WSAEI&NPROGRESSnbsp;  Uma bloqueio Windows Sockets operação está em andamento.
  
  
• WSAEMFILEnbsp;  &Não mais descritores de arquivo estão disponíveis.
  
  
• WSAE&NOBUFSnbsp;  Nenhum espaço de buffer está disponível. O soquete não pode ser criado.
  
  
• WSAEPROTO&NOSUPPORTnbsp;  A porta especificada não é suportada.
  
  
• WSAEPROTOTYPE   A porta especificada é o tipo errado para este Soquete.
  
  
• WSAESOCKT&NOSUPPORTnbsp;  O tipo de socket especificado não é suportado nesta família de endereços.

Parâmetros

nSocketPort

Um conhecido porta a ser usado com o soquete, ou 0 se desejar que o Windows Sockets selecionar uma porta.

nSocketType

SOCK_STREAM ou SOCK_DGRAM.

lEvent

Uma máscara de bits que especifica uma combinação de eventos de rede no qual o aplicativo está interessado.

• FD_READ   Deseja receber notificação de preparação para leitura.
  
  
• FD_WRITE   Deseja receber notificação de preparação para gravação.
  
  
• FD_OOB   Deseja receber notificação da chegada de dados fora de banda.
  
  
• FD_ACCEPT   Deseja receber notificação de conexões de entrada.
  
  
• FD_CO&NNECTnbsp;  Deseja receber notificação de conexão concluída.
  
  
• FD_CLOSE   Deseja receber notificação de fechamento de soquete.

lpszSockAddress

Um ponteiro para uma Cadeia de caracteres que contém o endereço de rede do soquete conectado, um número pontilhado, como "128.56.22.8".

Observações

Chame criar função de membro depois de construir um objeto de socket para criar o soquete do Windows e anexá-lo. Criar , em seguida, chama ligar para ligar o soquete para o endereço especificado. São suportados os seguintes tipos de soquete:

• SOCK_STREAM   Fornece fluxos de bytes seqüenciado, full duplex, confiável baseado em conexão. Usa o protocolo TCP (Transmission Controlar) para o família de endereços de Internet.
  
  
• SOCK_DGRAM   Oferece suporte a datagramas, que são pacotes sem conexão e não confiáveis de um comprimento máximo (geralmente pequeno) fixo. Usa o protocolo de datagrama de usuário (UDP) para o família de endereços de Internet.

  &Notanbsp;  O aceitar função de membro leva uma referência a um objeto de CSocket novo e vazio como seu parâmetro. Você deve construir esse objeto antes de chamar aceitar. Tenha em mente que, se este objeto de soquete ficar do escopo, fecha a conexão. Não chame criar para esse novo objeto de soquete.

Para obter mais informações sobre fluxo e datagrama soquetes, consulte os artigos Windows Sockets: plano de fundo e Windows Sockets: portas e endereços de soquete no Guia do programador do Visual C++ e Visão geral do Windows Sockets 2 e Windows Sockets Programming considerações na documentação do Win32 SDK.

Visão geral de CAsyncSocket |nbsp; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CAsyncSocket::Accept, CAsyncSocket::Bind, CAsyncSocket::Connect, CAsyncSocket::GetSock&Name,CAsyncSocket::IOCtl, CAsyncSocket::Listen, CAsyncSocket::Receive, CAsyncSocket::Send, CAsyncSocket::ShutDown