Función FwpsQueryPacketInjectionState0 (fwpsk.h)

  • Artículo

Una llamada llama a la función FwpsQueryPacketInjectionState0 para consultar el estado de inyección de datos del paquete.

NotaFwpsQueryPacketInjectionState0 es una versión específica de FwpsQueryPacketInjectionState. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.
 

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

Consulte también

FWPS_CLASSIFY_OUT0

FWPS_PACKET_INJECTION_STATE

FwpsInjectionHandleCreate0

NET_BUFFER_LIST

classifyFn