WSAEnumNetworkEvents

9/8/2008

Essa função descobre ocorrências de rede eventos para o Soquete, Clear indicado registros evento rede interna e redefinir evento objetos (opcional).

Syntax

int WSAEnumNetworkEvents(
  SOCKET s,
  WSAEVENT hEventObject,
  LPWSANETWORKEVENTS lpNetworkEvents
);

Parameters

• s
  [no] Descritor identificando a Soquete.

• hEventObject
  [no] Identificador opcional que identifica um associado objeto evento seja redefinir.

• lpNetworkEvents
  [out] Ponteiro para um WSANETWORKEVENTS estrutura que é preenchida com um registro de rede eventos ocorridos e qualquer associado códigos de erro.

Return Value

Se não houver erro, essa função retornará zero. Se um erro ocorrer, o valor retornado SOCKET_ERROR, e um número de erro específicas pode ser recuperado 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.
WSAEINVAL	Um dos parâmetros especificados era inválido.
WSAEINPROGRESS	Um bloqueio é chamar sockets do Windows (Winsock) em andamento, ou o serviço provedor ainda é processamento um função callback.
WSAENOTSOCK	O descritor não é um Soquete.
WSAEFAULT	O lpNetworkEvents argumento não for um válido parte espaço de endereço o usuário.

Remarks

Essa função é usada para descobrir qual rede eventos ocorreram para o Soquete indicado desde a última chamada desta função. Ela destina-se ao uso em conjunto com o WSAEventSelect função, que associa um objeto evento com um ou mais eventos rede. A gravação de eventos rede começar quando WSAEventSelect é chamado com um diferente de zero lNetworkEvents parâmetro e permanece aplicado até que outro chamar é feita WSAEventSelect Com o lNetworkEvents parâmetro definido como zero.

WSAEnumNetworkEvents apenas relata rede atividade e erros nomeados através WSAEventSelect. Consulte as descrições de Selecione Para localizar como essas funções relatório rede atividade e erros.

Registro interno do Soquete de rede eventos é copiado para a estrutura relacionado por lpNetworkEvents, depois que o registro eventos rede interna está desmarcado. Se a pasta hEventObject parâmetro não for NULL, também é o objeto evento indicado redefinir. O provedor Soquetes do Windows garante que as operações de copiar o registro evento rede, limpá-lo e redefinindo qualquer associado objeto evento são automáticas, que o próximo ocorrência de um evento indicado rede irá causar o objeto evento tornam-se definir. Na maiúsculas e minúsculas dessa função retornar SOCKET_ERROR, o associado objeto evento não está redefinir e o registro da rede eventos não está desmarcada.

O lNetworkEvents membro das WSANETWORKEVENTS estrutura indica quais o FD_XXX rede eventos ocorreram. O iErrorCode matriz é usado para conter qualquer associado códigos de erro com o índice de matriz correspondente para a posição de evento bits no lNetworkEvents. Identificadores, como FD_READ_BIT e FD_WRITE_BIT podem ser usados ao índice de iErrorCode matriz. Observe que somente esses elementos das iErrorCode matriz são definidas que corresponder como os bits definidos no lNetworkEvents parâmetro. Outros parâmetros não são modificados, o que é importante para compatibilidade com versões anteriores com os aplicativos que não estão cientes das novos eventos FD_ROUTING_INTERFACE_CHANGE e FD_ADDRESS_LIST_CHANGE.

O seguinte códigos de erro podem ser retornados along with o correspondente evento rede.

Evento: FD_CONNECT

Erro	Descrição
WSAEAFNOSUPPORT	Endereços de família especificado não podem ser usados com este Soquete.
WSAECONNREFUSED	Tentar conectar forçada foi rejeitada.
WSAENETUNREACH	A rede não pode ser alcançada através deste host neste momento.
WSAENOBUFS	Nenhuma espaço do buffer está disponível. O Soquete não pode ser conectada.
WSAETIMEDOUT	Tentar connecttimed limite sem estabelecer uma conexão

Evento: FD_CLOSE

Erro	Descrição
WSAENETDOWN	Falha no subsistema da rede.
WSAECONNRESET	A conexão foi redefinir pelo remoto lado.
WSAECONNABORTED	A conexão foi finalizada devido a um tempo limite ou outra falha.

Evento: FD_READ

Evento: FD_WRITE

Evento: FD_OOB

Evento: FD_ACCEPT

Evento: FD_ADDRESS_LIST_CHANGE

Erro	Descrição
WSAENETDOWN	Falha no subsistema da rede.

Evento: FD_ROUTING_INTERFACE_CHANGE

Erro	Descrição
WSAENETUNREACH	O destino especificado não está mais acessível.
WSAENETDOWN	Falha no subsistema da rede.

Requirements

Header	winsock2.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

select
WSAEventSelect
WSAGetLastError
WSAStartup