WSPEnumNetworkEvents
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 |