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. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

 

Sintaxis

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

Parámetros

[in] classifyContext

Parámetro classifyContext de classifyFn1. El motor DE PMA pasa este valor al del controlador de llamada clasifiqueFn.

[in] flags

Reservado para uso futuro. Establezca 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 a la solicitud de clasificación. Variable a la que apunta el parámetro classifyHandle contiene el identificador de la solicitud de clasificación.
otros códigos de estado	Error.

Observaciones

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	Valor
cliente mínimo admitido	Disponible a partir de Windows 7.
de la plataforma de destino de	Universal
encabezado de	fwpsk.h (incluya Fwpsk.h)
biblioteca de	Fwpkclnt.lib
irQL	<= DISPATCH_LEVEL

Consulte también

FwpsCompleteClassify0

fwpsPendClassify0

FwpsReleaseClassifyHandle0

clasificarFn

clasificarFn1