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

Artigo
03/08/2023

A função de retorno de chamada de evento WskAbortEvent notifica um aplicativo WSK de que uma solicitação de conexão de entrada em um soquete de escuta que tem o modo de aceitação condicional habilitado foi descartada.

Sintaxe

PFN_WSK_ABORT_EVENT PfnWskAbortEvent;

NTSTATUS PfnWskAbortEvent(
  [in, optional] PVOID SocketContext,
  [in]           PWSK_INSPECT_ID InspectID
)
{...}

Parâmetros

[in, optional] SocketContext

Um ponteiro para o contexto do soquete de escuta no qual a solicitação de conexão de entrada foi recebida. O aplicativo WSK forneceu esse ponteiro para o subsistema WSK quando chamou a função WskSocket para criar o soquete de escuta.

[in] InspectID

Um ponteiro para uma estrutura WSK_INSPECT_ID . O conteúdo da estrutura identifica a solicitação de conexão de entrada que foi descartada.

Retornar valor

A função de retorno de chamada de evento WskAbortEvent de um aplicativo WSK sempre deve retornar STATUS_SUCCESS.

Comentários

O subsistema WSK chama a função de retorno de chamada de evento WskAbortEvent de um aplicativo WSK somente quando as seguintes condições são verdadeiras:

O aplicativo WSK criou um soquete de escuta que tem o modo de aceitação condicional habilitado.
Uma solicitação de conexão de entrada foi recebida no soquete de escuta e o subsistema WSK chamou a função de retorno de chamada de evento WskInspectEvent do aplicativo WSK.
O aplicativo WSK retornou WskInspectPend ou WskInspectAccept de sua função de retorno de chamada de evento WskAbortEvent para a solicitação de conexão de entrada.
A solicitação de conexão de entrada foi descartada local ou remotamente antes de ser totalmente estabelecida.

Quando o subsistema WSK chama a função de retorno de chamada de evento WskAbortEvent de um aplicativo WSK, o aplicativo deve encerrar a inspeção para a solicitação de conexão de entrada. A solicitação de conexão é identificada pelo conteúdo da estrutura WSK_INSPECT_ID apontada pelo parâmetro InspectID .

Se o aplicativo WSK chamar a função WskInspectComplete em uma solicitação de conexão de entrada que foi anulada, a conexão não será estabelecida mesmo se WskInspectAccept for especificado no parâmetro Action .

Um aplicativo WSK pode habilitar o modo de aceitação condicional em um soquete de escuta habilitando a opção de soquete SO_CONDITIONAL_ACCEPT . Para obter mais informações sobre como aceitar condicionalmente conexões de entrada, consulte Escutando e aceitando Connections de entrada.

O subsistema WSK chama a função de retorno de chamada de evento WskAbortEvent de um aplicativo WSK em IRQL <= DISPATCH_LEVEL.

A função de retorno de chamada de evento WskAbortEvent 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 não gaste muito tempo no 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