Compartilhar via


WSPEnumNetworkEvents

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função relata as ocorrências de rede eventos para o Soquete indicado.

Syntax

int WSPEnumNetworkEvents(
  SOCKET s,
  WSAEVENT hEventObject,
  LPWSANETWORKEVENTS lpNetworkEvents,
  LPINT lpErrno 
);

Parameters

  • s
    [no] Descritor identificando a Soquete.
  • hEventObject
    [no] Um opcional identificador que identifica um associado objeto evento seja redefinir.
  • lpNetworkEvents
    [out] Ponteiro para um WSANETWORKEVENTS estrutura que é preenchida com um registro de eventos ocorreu rede qualquer associado códigos de erro. O WSANETWORKEVENTS estrutura é definida no seguinte texto.
  • lpErrno
    [out] Ponteiro para o código de erro.

Return Value

O valor de retorno será zero se a operação foi bem-sucedido. Caso contrário, o valor retornado SOCKET_ERROR e um número de erro específica 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.

WSAEINVAL

Indica que um dos parâmetros especificados estava inválido.

WSAEINPROGRESS

Um bloqueio é chamar Soquetes do Windows em andamento, ou o serviço provedor ainda é processamento um função callback.

WSAENOTSOCK

O descritor não é um Soquete.

Remarks

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

Essa função apenas relata rede atividade e erros nomeados através WSPEventSelect. Consulte a descrição de WSPSelect Para localizar fora como essa função relata erros e rede atividade.

Registro interno do Soquete de rede eventos é copiado para a estrutura relacionado por lpNetworkEvents, depois que o registro eventos rede interna está desmarcado. Se hEventObject não-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 redefinir quaisquer associado objeto evento são atômico, 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 seguinte amostra de código mostra como o WSANETWORKEVENTS estrutura está definida.

typedef struct _WSANETWORKEVENTS {
       long lNetworkEvents;
       int iErrorCode[FD_MAX_EVENTS];
} WSANETWORKEVENTS, FAR * LPWSANETWORKEVENTS;

O lNetworkEventmembro da estrutura indica qual dos eventos de rede FD_XXX ter ocorrido. O iErrorCode matriz é usado para conter qualquer associado códigos de erro, com índice de matriz correspondente para a posição de evento bits no lNetworkEvents. Os identificadores, como FD_READ_BIT e FD_WRITE_BIT podem ser usados ao índice de iErrorCodematriz.

Observe que somente esses elementos das iErrorCode matriz são definidas que corresponder como os bits definidos no lNetworkEvents membro. Outros membros não são modificados (isso é importante para compatibilidade com versões anteriores com os clientes que não estão cientes das novos eventos FD_ROUTING_INTERFACE_CHANGE e FD_ADDRESS_LIST_CHANGE Windows Socket 2 SPI).

O seguinte tabelas apresentação os códigos de erro que podem ser retornados along with o evento rede respectivos.

Evento: FD_CONNECT

Valor de 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

Rede não pode ser alcançada a partir este hospedar nesse tempo.

WSAENOBUFS

Nenhuma espaço do buffer está disponível. O Soquete não pode ser conectada.

WSAETIMEDOUT

Tentativa de conexão atingiu o tempo limite sem estabelecer uma conexão.

Evento: FD_CLOSE

Valor de erro Descrição

WSAENETDOWN

falha no subsistema de 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

Evento: FD_ROUTING_INTERFACE_CHANGE

Valor de erro Descrição

WSAENETUNREACH

Destino especificado não está mais acessível.

WSAENETDOWN

falha no subsistema de rede.

Valor de erro Descrição

WSAENETDOWN

falha no subsistema de rede.

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

WSPEventSelect