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 |