Função FwpsAcquireClassifyHandle0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsAcquireClassifyHandle0 gera um identificador de classificação usado para identificar operações de classificação assíncronas e solicitações de dados de camada graváveis.

ObservaçãoFwpsAcquireClassifyHandle0 é uma versão específica do FwpsAcquireClassifyHandle. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Parâmetros

[in] classifyContext

O parâmetro classifyContext de classifyFn1. O mecanismo WFP passa esse valor para o do driver de texto explicativo.

[in] flags

Reservado para uso futuro. Definido como 0.

[out] classifyHandle

Um ponteiro para uma variável que recebe um identificador de classificação. Esse identificador é necessário para chamadas de função subsequentes, conforme observado em Comentários.

Valor de retorno

A função FwpsAcquireClassifyHandle0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	Um identificador para a solicitação de classificação foi retornado com êxito. A variável que o classifyHandle aponta para conter o identificador da solicitação de classificação.
Outros códigos de status	Ocorreu um erro.

Observações

FwpsAcquireClassifyHandle0 é uma função de suporte para classificação assíncrona e modificação de dados. O identificador retornado por essa função é necessário como um parâmetro para as seguintes funções:

Para cada chamada para essa função, o driver de texto explicativo deve chamar FwpsReleaseClassifyHandle0 para liberar os recursos do sistema associados ao identificador.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 7.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Consulte também

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classificar Fn1

Partilhar via