Función FwpsPendClassify0 (fwpsk.h)

Artículo
03/05/2024

La función classifyFn de una llamada llama a FwpsPendClassify0 para pendizar la solicitud de clasificación actual. Después de que la solicitud esté manuscrita, el controlador de llamada debe completar el procesamiento de la solicitud de clasificación de forma asincrónica mediante una llamada a FwpsCompleteClassify0.

NotaFwpsPendClassify0 es una versión específica de FwpsPendClassify. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

Sintaxis

NTSTATUS FwpsPendClassify0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

Parámetros

[in] classifyHandle

Identificador de clasificación que identifica el procesamiento del controlador de llamada en la capa actual. Este identificador se obtiene mediante una llamada a FwpsAcquireClassifyHandle0.

[in] filterId

Valor del miembro FilterIddel parámetro filter de la función classifyFn. Para obtener más información sobre el miembro FilterId , vea FWPS_FILTER1.

[in] flags

Reservado para uso futuro. Establecer en cero.

[in, out] classifyOut

Establezca en el parámetro classifyOut de la función classifyFn del controlador de llamada. El parámetro classifyOut de classifyFn se muestra como un parámetro de salida en el encabezado, pero contiene suficiente información sobre la entrada para ser útil para el motor cuando se pasa a FwpsPendClassify.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La solicitud de clasificación se ha activado correctamente.
STATUS_FWP_CANNOT_PEND	El motor no permite la clasificación asincrónica en la capa desde la que se realizó la llamada.
Otros códigos de estado	Se produjo un error.

Comentarios

FwpsPendClassify0 coloca la clasificación del evento indicado en un estado en lápiz. Normalmente, un controlador de llamada escribe en lápiz la clasificación para que se pueda realizar más procesamiento fuera del ámbito de la función de llamada classifyFn . Después, el controlador de llamada puede pasar el identificador de clasificación y cualquier otro dato pertinente sobre la indicación a una función con menos impacto en el rendimiento que las funciones de llamada del controlador. Una vez completado el procesamiento, la llamada debe llamar a FwpsCompleteClassify0 para quitar el estado en lápiz. En el momento de la llamada a FwpsCompleteClassify, el controlador de llamada debe devolver una estructura de FWPS_CLASSIFY_OUT0 rellenada como lo haría en una clasificación insertada.

FwpsPendClassify0 incrementa el recuento de referencias del identificador de clasificación pasado en el parámetro classifyHandle . Una vez que el controlador de llamada llama a esta función, puede llamar a FwpsReleaseClassifyHandle0 para liberar la instancia local. Cuando se llama a FwpsCompleteClassify0 , la referencia al identificador se disminuirá automáticamente.

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