CAsyncSocket::Bind

Artigo
02/25/2013

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.