Função FwpsAcquireClassifyHandle0 (fwpsk.h)

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.

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 classifyFn do driver de texto explicativo.

[in] flags

Reservado para uso futuro. Defina 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.

Retornar valor

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 para a qual o parâmetro classifyHandle aponta contém o identificador da solicitação de classificação.
Outros códigos status	Ocorreu um erro.

Comentários

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:

• FwpsPendClassify0

• FwpsAcquireWritableLayerDataPointer0
• FwpsApplyModifiedLayerData0

• FwpsCompleteClassify0

• FwpsReleaseClassifyHandle0

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
Cliente mínimo com suporte	Disponível a partir do Windows 7.
Plataforma de Destino	Universal
Cabeçalho	fwpsk.h (inclua Fwpsk.h)
Biblioteca	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Confira também

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1