CAsyncSocket::escutar
Chame essa função de membro para escutar solicitações de conexão de entrada.
BOOL Listen(
int nConnectionBacklog = 5
);
Parâmetros
- nConnectionBacklog
O comprimento máximo para o qual a fila de conexões pendentes pode crescer.Intervalo válido é de 1 a 5.
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.
WSAEADDRINUSE Foi feita uma tentativa para escutar um endereço em uso.
WSAEINPROGRESS Uma operação de bloqueio de Windows Sockets está em andamento.
WSAEINVAL O soquete não foi limite com BIND ou já está conectado.
WSAEISCONN O soquete já conectado.
WSAEMFILE Não há mais descritores de arquivo estão disponível.
WSAENOBUFS Nenhum espaço do buffer está disponível.
WSAENOTSOCK O descritor não é um soquete.
WSAEOPNOTSUPP O soquete referenciado não é de um tipo que ofereça suporte a Listen operação.
Comentários
Para aceitar conexões, o soquete é criado pela primeira vez com Criarespecificada com , uma lista de pendências para conexões de entradaListen, e, em seguida, as conexões são aceitas com Aceitar.Listen aplica-se somente ao que suportam conexões, isto é, de tipo SOCK_STREAM.Nesse soquete é colocado em modo "passivo" where conexões de entrada são confirmadas e na na fila pendentes aceitação pelo processo.
Esta função é geralmente usada por servidores (ou qualquer aplicativo que deseja aceitar conexões) que pode ter mais de uma solicitação de conexão por vez: Se chegar uma solicitação de conexão com a fila completa, o cliente receberá um erro com uma indicação de WSAECONNREFUSED.
Listen tenta continuar a funcionar racionalmente quando nenhuma porta disponível (descritores). Ele aceitará conexões até que a fila seja esvaziada.Se as portas se tornarem disponível, uma telefonar posterior para Listen ou Aceitar reabastecer a fila de registro o corrente ou mais recente "posterior," se possível e retomar a escutar conexões de entrada.
Requisitos
Cabeçalho: afxsock.h