PFN_WSK_DISCONNECT_EVENT função de retorno de chamada (wsk.h)

Artigo
08/08/2023

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