Función FwpsAcquireClassifyHandle0 (fwpsk.h)

La función FwpsAcquireClassifyHandle0 genera un identificador de clasificación que se usa para identificar las operaciones de clasificación asincrónicas y las solicitudes de datos de capa grabables.

NotaFwpsAcquireClassifyHandle0 es una versión específica de FwpsAcquireClassifyHandle. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

 

Sintaxis

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

Parámetros

[in] classifyContext

Parámetro classifyContext de classifyFn1. El motor DEL PMA pasa este valor a la clasificación del controlador de llamadaFn.

[in] flags

Reservado para uso futuro. Establecer en 0.

[out] classifyHandle

Puntero a una variable que recibe un identificador de clasificación. Las llamadas de función posteriores necesitan este identificador, como se indica en Comentarios.

Valor devuelto

La función FwpsAcquireClassifyHandle0 devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	Se devolvió correctamente un identificador de la solicitud de clasificación. La variable a la que apunta el parámetro classifyHandle contiene el identificador de la solicitud de clasificación.
Otros códigos de estado	Se produjo un error.

Comentarios

FwpsAcquireClassifyHandle0 es una función de compatibilidad para la clasificación asincrónica y la modificación de datos. El identificador devuelto por esta función es necesario como parámetro para las siguientes funciones:

• FwpsPendClassify0

• FwpsAcquireWritableLayerDataPointer0
• FwpsApplyModifiedLayerData0

• FwpsCompleteClassify0

• FwpsReleaseClassifyHandle0

Para cada llamada a esta función, el controlador de llamada debe llamar a FwpsReleaseClassifyHandle0 para liberar los recursos del sistema asociados al identificador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 7.
Plataforma de destino	Universal
Encabezado	fwpsk.h (incluya Fwpsk.h)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Consulte también

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classifyFn

classifyFn1