Compartilhar via


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

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

Confira também

WSK_CLIENT_LISTEN_DISPATCH

WSK_INSPECT_ID

WskControlSocket

WskInspectComplete

WskInspectEvent

WskSocket