Función FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

Artículo
08/07/2023

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. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

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 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.

[out] writableLayerData

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 convirtiendo el puntero void al tipo de estructura adecuado.

[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 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	Se produjo un error.

Comentarios

FwpsAcquireWritableLayerDataPointer0 establece los siguientes miembros de la estructura FWPS_CLASSIFY_OUT0 :

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->rights &= ~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 ha modificado ningún dato. Si no realiza la llamada a FwpsApplyModifiedLayerData0, esto podría dar lugar a 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	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