CAsyncSocket::Connect

BOOL Connect ( LPCTSTR lpszHostAddress, UINT nHostPort );

BOOL Connect ( const SOCKADDR * lpSockAddr, int nSockAddrLen );

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. Se isso indica um código de erro de WSAEWOULDBLOCK, e seu aplicativo está usando os retornos de chamada substituíveis, seu aplicativo receberá uma OnConnect mensagem quando o Conectar operação for concluído. 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.
  
  
• WSAEADDRI&NUSEnbsp;  O endereço especificado já está em uso.
  
  
• WSAEI&NPROGRESSnbsp;  Uma bloqueio Windows Sockets chamada está em andamento.
  
  
• WSAEADDR&NOTAVAILnbsp;  O endereço especificado não está disponível a partir da máquina local.
  
  
• WSAEAF&NOSUPPORTnbsp;  Endereços da família especificado não podem ser usados com este Soquete.
  
  
• WSAECO&NNREFUSEDnbsp;  A tentativa de conexão foi rejeitada.
  
  
• WSAEDESTADDRREQ   É necessário um endereço de destino.
  
  
• WSAEFAULTO   O argumento nSockAddrLen está incorreto.
  
  
• WSAEI&NVALnbsp;  Endereço de host inválido.
  
  
• WSAEISCO&NNnbsp;  O soquete já está conectado.
  
  
• WSAEMFILEnbsp;  &Não mais descritores de arquivo estão disponíveis.
  
  
• WSAE&NETUNREACHnbsp;  A rede não pode ser alcançada através deste host neste momento.
  
  
• WSAE&NOBUFSnbsp;  Nenhum espaço de buffer está disponível. O soquete não pode ser conectado.
  
  
• WSAE&NOTSOCKnbsp;  O descritor não é um soquete.
  
  
• WSAETIMEDOUT   Tentativa de conexão cronometrada fora sem estabelecer uma conexão.
  
  
• &Nbsp WSAEWOULDBLOCK;  O soquete é marcado como de não bloqueio e a conexão não pode ser concluída imediatamente.

Parâmetros

lpszHostAddress

O endereço de rede do soquete para o qual este objeto está conectado: um nome de máquina, como "ftp.microsoft.com" ou um número pontilhado, como "128.56.22.8".

nHostPort

A porta que identifica o aplicativo de soquete.

lpSockAddr

Um ponteiro para uma estrutura SOCKADDR que contém o endereço de soquete conectado.

nSockAddrLen

O comprimento do endereço em lpSockAddr em bytes.

Observações

Chame essa função de membro para estabelecer uma conexão com um fluxo sem ligação ou um soquete de datagrama. Se o soquete é desacoplado, valores exclusivos são atribuídos para a associação local, o sistema e o soquete está marcada como ligado. Observe que, se o campo de endereço da nome estrutura é todos os zeros, Conectar retornará zero. Para obter informações de erro estendidas, chame a função de membro GetLastError.

Para soquetes de fluxo (tipo SOCK_STREAM), um conexão ativa é iniciado para o hospedar externo. Quando a chamada de soquete é concluída com êxito, o soquete está pronto para enviar/receber dados.

Para um soquete de datagrama (tipo SOCK_DGRAM), um destino padrão é definido, que será usado em subseqüentes Enviar e receber chamadas.

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

Consulte tambémnbsp;CAsyncSocket::Accept, CAsyncSocket::Bind, CAsyncSocket::GetSock&Name, CAsyncSocket::Create, CAsyncSocket::AsyncSelect