FwpsQueryPacketInjectionState0, fonction (fwpsk.h)
La fonction FwpsQueryPacketInjectionState0 est appelée par une légende pour interroger l’état d’injection des données de paquets.
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 qui a été créé précédemment par un appel au fonction FwpsInjectionHandleCreate0.
[in] netBufferList
Pointeur vers une structure NET_BUFFER_LIST qui décrit les données de paquets classifiées. 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 dans 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 lorsque le paquet a été injecté est retourné.
Valeur de retour
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 paquet injectées peuvent être reclassées par rapport à la légende qui l’a injectée, cette fonction permet à une légende d’inspecter l’historique d’injection des données de paquets si nécessaire, ce qui évite de devoir 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 aux légendes en spécifiant le handle facultatif injectionContext 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, le 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 ni mise en attente 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 classOut de la fonction classifiableFn sur FWP_ACTION_CONTINUE ou FWP_ACTION_PERMIT. Cela permet au paquet de passer à la légende suivante.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows Vista. |
| plateforme cible | Universel |
| d’en-tête | fwpsk.h (include Fwpsk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |