FwpsQueryPacketInjectionState0, fonction (fwpsk.h)

  • Article

La fonction FwpsQueryPacketInjectionState0 est appelée par une légende pour interroger l’état d’injection des données de paquets.

RemarqueFwpsQueryPacketInjectionState0 est une version spécifique de FwpsQueryPacketInjectionState. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .
 

Syntaxe

FWPS_PACKET_INJECTION_STATE FwpsQueryPacketInjectionState0(
  [in]            HANDLE                injectionHandle,
  [in]            const NET_BUFFER_LIST *netBufferList,
  [out, optional] HANDLE                *injectionContext
);

Paramètres

[in] injectionHandle

Handle d’injection précédemment créé par un appel à Fonction FwpsInjectionHandleCreate0 .

[in] netBufferList

Pointeur vers une structure de NET_BUFFER_LIST qui décrit les données de paquets en cours de classification. Le paquet peut provenir de la pile réseau, ou il peut être injecté dans la pile réseau par un pilote de légende PAM.

[out, optional] injectionContext

Handle facultatif pour le contexte d’injection. Si le pointeur est spécifié et si l’état d’injection de paquets FWPS_PACKET_INJECTION_STATE associé au handle d’injection est FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, le contexte d’injection fourni lors de l’injection du paquet est retourné.

Valeur retournée

La fonction FwpsQueryPacketInjectionState0 retourne l’une des valeurs constantes de l’énumération FWPS_PACKET_INJECTION_STATE .

Remarques

Étant donné que les données de paquets injectées peuvent être reclassées par rapport à la légende qui les a injectées, cette fonction permet à une légende d’inspecter l’historique d’injection des données de paquets si nécessaire, évitant ainsi d’avoir à effectuer des inspections répétées des données de paquets qui ont déjà été inspectées.

Une légende peut suivre d’autres informations spécifiques à la légende en spécifiant le handle injectionContext facultatif dans l’une des fonctions d’injection de paquets au moment de l’injection de données de paquets. Si la fonction FwpsQueryPacketInjectionState0 retourne FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, l’injectionContext fourni est retourné en tant que paramètre completionContext de la fonction qui a effectué l’injection.

Si la valeur de retour est FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF, la liste de mémoires tampons réseau pointée par netBufferList ne doit pas être modifiée ou suspendu dans le cadre d’une procédure de clonage et d’injection. Dans ce cas, la légende doit définir le membre actionType de la structure FWPS_CLASSIFY_OUT0 pointée par le paramètre classifyOut de la fonction classifyFnsur FWP_ACTION_CONTINUE ou FWP_ACTION_PERMIT. Cela permet au paquet de passer à la légende suivante.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
Plateforme cible Universal
En-tête fwpsk.h (include Fwpsk.h)
Bibliothèque Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

Voir aussi

FWPS_CLASSIFY_OUT0

FWPS_PACKET_INJECTION_STATE

FwpsInjectionHandleCreate0

NET_BUFFER_LIST

classifyFn