PFN_WSK_DISCONNECT_EVENT função de retorno de chamada (wsk.h)
A função de retorno de chamada de evento WskDisconnectEvent notifica um aplicativo WSK de que uma conexão em um soquete orientado à conexão foi desconectada pelo aplicativo remoto.
Sintaxe
PFN_WSK_DISCONNECT_EVENT PfnWskDisconnectEvent;
NTSTATUS PfnWskDisconnectEvent(
[in, optional] PVOID SocketContext,
[in] ULONG Flags
)
{...}
Parâmetros
[in, optional] SocketContext
Um ponteiro para o contexto do soquete para o soquete orientado à conexão que foi desconectado. O aplicativo WSK forneceu esse ponteiro para o subsistema WSK de uma das seguintes maneiras:
- Ele chamou a função WskSocket para criar o soquete.
- Ele chamou a função WskSocketConnect para criar o soquete.
- Ele chamou a função WskAccept para aceitar o soquete como uma conexão de entrada.
- Sua função de retorno de chamada de evento WskAcceptEvent foi chamada para aceitar o soquete como uma conexão de entrada.
[in] Flags
Um valor ULONG que contém um OR bit a bit de uma combinação dos seguintes sinalizadores:
WSK_FLAG_ABORTIVE
O aplicativo remoto executou uma desconexão anulativa do soquete. Se esse sinalizador não estiver definido, o aplicativo remoto executará uma desconexão normal do soquete.
WSK_FLAG_AT_DISPATCH_LEVEL
O subsistema WSK chamado função de retorno de chamada de evento WskDisconnectEvent no IRQL = DISPATCH_LEVEL. Se esse sinalizador não estiver definido, o subsistema WSK poderá ter chamado a função de retorno de chamada de evento WskDisconnectEvent em qualquer <DO IRQL = DISPATCH_LEVEL.
Valor de retorno
A função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK deve sempre retornar STATUS_SUCCESS.
Observações
O subsistema WSK chama a função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK quando um soquete orientado à conexão é desconectado pelo aplicativo remoto somente se a função de retorno de chamada de evento tiver sido habilitada anteriormente com a opção de soquete SO_WSK_EVENT_CALLBACK. Para obter mais informações sobre como habilitar as funções de retorno de chamada de evento de um soquete, consulte Habilitar e desabilitar funções de retorno de chamada de evento.
Se o aplicativo remoto tiver executado uma desconexão normal do soquete, nenhum dado adicional será recebido do soquete. No entanto, o aplicativo WSK ainda pode enviar dados para o soquete até que o soquete seja completamente fechado pelo aplicativo remoto ou o aplicativo WSK chame a função WskDisconnect ou a função WskCloseSocket no soquete.
Se o aplicativo remoto tiver realizado uma desconexão anulativa do soquete, nenhum dado adicional será recebido do soquete e nenhum dado adicional poderá ser enviado ao soquete.
O subsistema WSK chama a função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK no IRQL <= DISPATCH_LEVEL.
A função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK não deve aguardar a conclusão de outras solicitações do WSK no contexto de funções de conclusão do WSK ou retorno de chamada de evento. O retorno de chamada pode iniciar outras solicitações do WSK (supondo que ele não gaste muito tempo no DISPATCH_LEVEL), mas não deve aguardar sua conclusão mesmo quando o retorno de chamada é chamado em IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Windows |
| cabeçalho | wsk.h (inclua Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |