listen

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Esta função coloca um Soquete em um estado onde ele está aguardando uma conexão de entrada.

Syntax

int listen(
  SOCKET s,
  int backlog
);

Parameters

s
[no] Descritor identificando um ligado, Soquete desconectado.

Registro posterior
[no] Comprimento Máximo de fila de pendente conexões. Se Registro posterior é definido como SOMAXCONN, o subjacente provedor serviço responsável Soquete s definirá o registro posterior para um valor razoável máximo. Não há nenhum padrão configurar para obter o real backlog valor.

Return Value

Se não houver erro, essa função retornará zero. Se um erro ocorrer, será retornado um valor de SOCKET_ERROR, e um código de erro específicos podem ser recuperadas por chamado WSAGetLastError.

A seguinte tabela mostra uma lista dos códigos de erro possível.

Código de erro	Descrição
WSANOTINITIALISED	Um bem-sucedido WSAStartup chamar deve ocorrer antes de usar essa função.
WSAENETDOWN	Falha no subsistema da rede.
WSAEADDRINUSE	Local do Soquete o endereço já está em uso e a Soquete não foi marcado para Permitir reutilização endereço com SO_REUSEADDR. Esse erro geralmente ocorre durante a execução das BIND (Soquetes do Windows) função, mas ele pode ser adiada até a escutar função se era o BIND para um parcialmente curinga endereço (envolvendo ADDR_ANY) e se um endereço específico precisa ser confirmada no tempo da escutar função.
WSAEINPROGRESS	Um bloqueio é chamar sockets do Windows (Winsock) em andamento, ou o serviço provedor ainda é processamento um função callback.
WSAEINVAL	O Soquete não foi ligado com BIND.
WSAEISCONN	O Soquete já está conectado.
WSAEMFILE	Há mais descritores Soquete estiver disponível.
WSAENOBUFS	Nenhuma espaço do buffer está disponível.
WSAENOTSOCK	O descritor não é um Soquete.
WSAEOPNOTSUPP	O relacionado Soquete não é de um tipo que ofereça suporte a operação escutar.

Remarks

Para aceitar conexões, um Soquete é criada pela primeira vez com o Soquete (Soquetes do Windows) função e ligado a um local endereço com o BIND (Soquetes do Windows) função, um registro posterior para de entrada Conexões for especificado com escutar, e as conexões são aceitos com o aceitar (Soquetes do Windows) função. Soquetes orientado à conexão, que são as de tipo SOCK_STREAM de exemplo, são usados com escutar. Soquete s é pôr em modo passivo onde conexão de entrada solicitações são confirmadas e enfileirado pendente aceitação pelo processo.

O escutar função é geralmente usado por servidores que podem ter um more than solicitação de conexão em um tempo. Se chega uma solicitação de conexão e a fila está cheia, o cliente receberá um erro com uma indicação de WSAECONNREFUSED.

Se não houver nenhum disponível descritores Soquete, escutar Tenta continuar a função. Se descritores ficar disponível, um chamar posterior para escutar Ou aceitar Será encher a fila para o atual ou mais recente registro posterior, se possível e continuar aguardando de entrada Conexões.

Anotações de Sockets IrDA

O arquivo cabeçalho Af_irda.h deve ser explicitamente incluído.

Para obter mais inforamtion sobre suporte IrDA no Windows Embedded CE, consulte Comunicação via infravermelho.

Observações para Bluetooth

Chama um servidor RFCOMM Winsock escutar Para pôr RFCOMM em um modo no qual ele irá aceitar conexões de canalizar. O valor do registro posterior de RFCOMM será 0. Chamando escutar não anuncia o serviço no banco de dados de SDP.

Compatibilidade

O Registro posterior parâmetro é limitado (silenciosamente) a um valor razoável, conforme determinado pelo subjacente provedor serviço. Valores inválidos são substituídos pelo valor válido mais próximo. Não há nenhum padrão configurar para localizar sem o real backlog valor.

Requirements

Header	winsock2.h
Library	Ws2.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later