Función FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Artículo
02/07/2025

La función FwpsAcquireWritableLayerDataPointer0 devuelve datos específicos de la capa que se pueden inspeccionar y cambiar.

NotafwpsAcquireWritableLayerDataPointer0 es una versión específica de FwpsAcquireWritableLayerDataPointer. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información.

Sintaxis

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

Parámetros

[in] classifyHandle

Identificador de la solicitud de clasificación. Este identificador se obtiene mediante una llamada a FwpsAcquireClassifyHandle0.

[in] filterId

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

[in] flags

Reservado para uso futuro. Establézcalo en cero.

[out] writableLayerData

Un búfer de datos que contiene los datos modificables para la capa. Los tipos de datos admitidos, que se enumeran en la siguiente sección Comentarios, se definen como estructuras. A la devolución, se puede acceder a los datos mediante la conversión del puntero void al tipo de estructura adecuado.

[in, out] classifyOut

Establézcalo en el parámetro classifyOut de la función de clasifiqueFn 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 FwpsAcquireWritableLayerDataPointer0.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	La función de devolución de llamada se registró correctamente.
otros códigos de estado	Error.

Observaciones

FwpsAcquireWritableLayerDataPointer0 establece los siguientes miembros de la estructura de FWPS_CLASSIFY_OUT0:

clasificarOut->actionType = FWP_ACTION_BLOCK
los derechos de clasificación-> &= ~FWPS_RIGHT_ACTION_WRITE

Para cada llamada a esta función, debe realizar una llamada coincidente a FwpsApplyModifiedLayerData0 para finalizar los cambios realizados, incluso si el controlador de llamada no modificó ningún dato. Si no realiza la llamada a FwpsApplyModifiedLayerData0, esto podría provocar que la clasificación no se complete correctamente.

Las estructuras siguientes se definen para contener datos de capa modificables. El puntero establecido en la salida como parámetro writableLayerData se puede convertir a uno de estos tipos:

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