Fonction FwpmNetEventSubscribe2 (fwpmu.h)
La fonction FwpmNetEventSubscribe2 est utilisée pour demander la remise de notifications concernant un événement net particulier.
Syntaxe
DWORD FwpmNetEventSubscribe2(
[in] HANDLE engineHandle,
[in] const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
[in] FWPM_NET_EVENT_CALLBACK2 callback,
[in, optional] void *context,
[out] HANDLE *eventsHandle
);
Paramètres
[in] engineHandle
Handle pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in] subscription
Structure FWPM_NET_EVENT_SUBSCRIPTION0 qui décrit les notifications qui seront remises.
[in] callback
Pointeur vers une fonction de type FWPM_NET_EVENT_CALLBACK2 qui sera appelée lorsqu’une notification est prête pour la remise.
[in, optional] context
Pointeur de contexte facultatif. Ce pointeur est passé à la fonction de rappel avec les détails de l’événement.
[out] eventsHandle
Gérez l’abonnement nouvellement créé. Appelez FwpmNetEventUnsubscribe0 pour fermer ce handle lorsque l’abonnement n’est plus nécessaire.
Valeur retournée
Code/valeur de retour | Description |
---|---|
|
L’abonnement a été créé avec succès. |
|
Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM . |
|
Échec de la communication avec le moteur de pare-feu distant ou local. |
Remarques
Cette fonction ne peut pas être appelée à partir d’une transaction. Elle échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.
L’appelant a besoin d’un accès FWPM_ACTRL_SUBSCRIBE au conteneur de l’événement net.
Configuration requise
Client minimal pris en charge | Windows 10, version 1607 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2016 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | fwpmu.h |
Bibliothèque | Fwpuclnt.lib |
DLL | Fwpuclnt.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour