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 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 |