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 de 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 abortiva 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 em 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 IRQL <= DISPATCH_LEVEL.
Retornar valor
A função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK sempre deve retornar STATUS_SUCCESS.
Comentários
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 foi 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 Habilitando e desabilitando 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 executado uma desconexão abortiva do soquete, nenhum dado adicional será recebido do soquete e nenhum dado adicional poderá ser enviado para o soquete.
O subsistema WSK chama a função de retorno de chamada de evento WskDisconnectEvent de um aplicativo WSK em 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 das funções de retorno de chamada de evento ou de conclusão do WSK. O retorno de chamada pode iniciar outras solicitações do WSK (supondo que ele não gaste muito tempo em DISPATCH_LEVEL), mas não deve aguardar a conclusão mesmo quando o retorno de chamada é chamado em IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Plataforma de Destino | Windows |
| Cabeçalho | wsk.h (inclua Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |