Compartir a través de


Función FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)

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

Consulte también

FWPS_BIND_REQUEST0

FWPS_CLASSIFY_OUT0

FWPS_CONNECT_REQUEST0

FWPS_FILTER1

FwpsAcquireClassifyHandle0

FwpsApplyModifiedLayerData0

FwpsReleaseClassifyHandle0

classifyFn