Función FwpsQueryPacketInjectionState0 (fwpsk.h)
Una llamada llama a la función FwpsQueryPacketInjectionState0 para consultar el estado de inyección de datos del paquete.
Sintaxis
FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
[in] HANDLE injectionHandle,
[in] const NET_BUFFER_LIST *netBufferList,
[out, optional] HANDLE *injectionContext
);
Parámetros
[in] injectionHandle
Identificador de inyección creado previamente por una llamada a Función FwpsInjectionHandleCreate0 .
[in] netBufferList
Puntero a una estructura de NET_BUFFER_LIST que describe los datos de paquete que se están clasificando. El paquete se puede originar en la pila de red o se puede insertar en la pila de red mediante un controlador de llamada de PMA.
[out, optional] injectionContext
Identificador opcional para el contexto de inyección. Si se especifica el puntero y si el estado de inyección de paquetes FWPS_PACKET_INJECTION_STATE asociado al identificador de inyección es FWPS_PACKET_INJECTED_BY_SELF o FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, se devolverá el contexto de inyección proporcionado cuando se insertó el paquete.
Valor devuelto
La función FwpsQueryPacketInjectionState0 devuelve uno de los valores constantes de la enumeración FWPS_PACKET_INJECTION_STATE .
Comentarios
Dado que los datos de paquetes insertados se pueden reclasificar en la llamada que lo insertó, esta función permite que una llamada inspeccione el historial de inyección de datos de paquetes cuando sea necesario, lo que evita la necesidad de realizar inspecciones repetidas de los datos de paquetes que ya se han inspeccionado.
Una llamada puede realizar un seguimiento de otra información específica de la llamada especificando el identificador opcional injectionContext en una de las funciones de inyección de paquetes en el momento de la inserción de datos de paquetes. Si la función FwpsQueryPacketInjectionState0 devuelve FWPS_PACKET_INJECTED_BY_SELF o FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, se devolverá el parámetro injectionContext proporcionado como parámetro completionContext de la función que realizó la inserción.
Si el valor devuelto es FWPS_PACKET_INJECTED_BY_SELF o FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, la lista de búferes de red a la que apunta netBufferList no debe modificarse ni escribirse como parte de un procedimiento de clonación e inyección. En este caso, la llamada debe establecer el miembro actionType de la estructura FWPS_CLASSIFY_OUT0 a la que apunta el parámetro classifyOut de la función classifyFn en FWP_ACTION_CONTINUE o FWP_ACTION_PERMIT. Esto permite que el paquete continúe con la siguiente llamada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows Vista. |
| Plataforma de destino | Universal |
| Encabezado | fwpsk.h (incluya Fwpsk.h) |
| Library | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |