Función FwpsAcquireWritableLayerDataPointer0 (fwpsk.h)
La función FwpsAcquireWritableLayerDataPointer0 devuelve datos específicos de la capa que se pueden inspeccionar y cambiar.
NTSTATUS FwpsAcquireWritableLayerDataPointer0(
[in] UINT64 classifyHandle,
[in] UINT64 filterId,
[in] UINT32 flags,
[out] PVOID *writableLayerData,
[in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);
[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.
La función FwpsAcquireWritableLayerDataPointer0 devuelve uno de los siguientes códigos NTSTATUS.
Código devuelto | Descripción |
---|---|
|
La función de devolución de llamada se registró correctamente. |
|
Se produjo un error. |
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:
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 |