WSPListen

9/8/2008

Essa função estabelece um Soquete para escutar para de entrada Conexões.

Syntax

int WSPListen(
  SOCKET s,
  int backlog,
  LPINT lpErrno 
);

Parameters

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

• Registro posterior
  [no] Comprimento máximo para o qual a fila de pendente conexões podem aumentar. Se esse valor for SOMAXCONN, em seguida, provedor de serviço deve definido o registro posterior como um máximo "razoável" valor. Não há nenhum padrão configurar para localizar sem o real backlog valor.

• lpErrno
  [out] Ponteiro para o código de erro.

Return Value

Se não houver erro, essa função retornará zero. Caso contrário, será retornado um valor de SOCKET_ERROR e um código de erro específico está disponível em lpErrno.

A seguinte tabela mostra os códigos de erro possível.

Valor de erro	Descrição
WSAENETDOWN	falha no subsistema de rede.
WSAEADDRINUSE	Local do Soquete 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 no tempo de BIND, mas pode ser atrasada até que essa função se a BIND Era um endereço curinga parcialmente (envolvendo ADDR_ANY) e se um endereço específico precisa ser confirmada no tempo desta função.
WSAEINPROGRESS	Função é chamada quando um callback é em andamento.
WSAEINVAL	Soquete não foi ligado com WSPBind.
WSAEISCONN	Soquete já 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	Soquete referenciado não é de um tipo que ofereça suporte a WSPListen operação.

Remarks

Para aceitar conexões, um Soquete é criada pela primeira vez com WSPSocket ligado a um local com endereço WSPBind, um registro posterior para de entrada Conexões for especificado com WSPListen, e em seguida, as conexões são aceitos com WSPAccept. WSPListen Aplica-se somente a soquetes que são orientado (por exemplo, conexão SOCK_STREAM). O Soquete s é pôr em modo passivo onde conexão de entrada solicitações são confirmadas e enfileirado pendente aceitação pelo cliente de Windows Sockets SPI.

Essa função é geralmente usado por servidores que poderia ter um more than solicitação de conexão em um tempo. Se um solicitação de conexão chega com a fila completa, o cliente receberá um erro com uma indicação de WSAECONNREFUSED.

Esta função deve continuar a função racionalmente quando não houver nenhum disponível descritores. Ele deve aceitar conexões até que a fila é esvaziada. Se descritores ficar disponível, um chamar posterior para WSPListen Ou WSPAccept Será encher a fila para o atual ou mais recente registro posterior, se possível e continuar aguardando de entrada Conexões.

Um cliente Windows Sockets SPI pode chamar esta função mais de uma vez sobre o mesmo Soquete. Isso tem o efeito de atualizar o atual registro posterior para o Soquete de escuta. Deve haver mais pendente conexões que o novo Registro posterior valor, o pendente excesso de conexões será redefinir e ignorados.

Compatibilidade

Registro posterior é limitada (silenciosamente) a um valor razoável como determinado pelo provedor de 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	ws2spi.h
Library	Ws2.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

WSPAccept
WSPConnect
WSPSocket