Partilhar via


CAsyncSocket::Bind

Chamar essa função de membro para associar um endereço local com o soquete.

BOOL Bind( 
   UINT nSocketPort, 
   LPCTSTR lpszSocketAddress = NULL  
); 
BOOL Bind ( 
   const SOCKADDR* lpSockAddr, 
   int nSockAddrLen  
);

Parâmetros

  • nSocketPort
    A porta que identifica o aplicativo de soquete.

  • lpszSocketAddress
    O endereço de rede, um número pontilhada como “128.56.22.8”. Passe a cadeia de caracteres de NULO para esse parâmetro indica que a instância de CAsyncSocket devem escutar pela atividade de cliente em todas as interfaces de rede.

  • lpSockAddr
    Um ponteiro a estrutura de SOCKADDR que contém o endereço para atribuir a este soquete.

  • nSockAddrLen
    O comprimento do endereço em lpSockAddr em bytes.

Valor de retorno

Diferente de zero se a função é com êxito; se não 0, e um código de erro específico podem ser recuperados chamando GetLastError. Os seguintes erros se aplicam a essa função de membro:

  • WSANOTINITIALISED A AfxSocketInit com êxito deve ocorrer antes de usar este API.

  • WSAENETDOWN a implementação da do windows detectou que o subsistema de rede falhou.

  • WSAEADDRINUSE o endereço especificado está sendo usado. (Consulte a opção de soquete de SO_REUSEADDR em SetSockOpt.)

  • WSAEFAULT o argumento de nSockAddrLen é muito pequeno (menos que o tamanho de uma estrutura de SOCKADDR ).

  • A chamada da do windows de bloqueio deWSAEINPROGRESS A está em andamento.

  • WSAEAFNOSUPPORT a família de endereço especificada não é suportado pela porta.

  • WSAEINVAL o soquete já esteja associado a um endereço.

  • WSAENOBUFS não sejam armazenar em buffer disponível, conexões demais.

  • WSAENOTSOCK o descritor não for um soquete.

Comentários

Esta rotina é usada em um soquete desconectado de datagrama ou de fluxo, antes que Conectar subseqüente ou chamadas de Listen . Antes que possa aceitar solicitações de conexão, um soquete escuta do servidor deve selecionar um número de porta e torná-lo conhecido aos soquetes do windows chamando Ligar. Ligar institui a associação local (endereço do host/número de porta) de soquete atribuir um nome local a um soquete sem nome.

Requisitos

Cabeçalho: afxsock.h

Consulte também

Referência

Classe CAsyncSocket

Gráfico da hierarquia

CAsyncSocket::Connect

CAsyncSocket::Listen

CAsyncSocket::GetSockName

CAsyncSocket::SetSockOpt

CAsyncSocket::Create