Fonction FwpmNetEventSubscribe3 (fwpmu.h)

Article
05/03/2024

Utilisé pour demander la remise de notifications concernant un événement net particulier.

Syntaxe

DWORD FwpmNetEventSubscribe3(
  HANDLE                             engineHandle,
  const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  FWPM_NET_EVENT_CALLBACK3           callback,
  void                               *context,
  HANDLE                             *eventsHandle
);

Paramètres

engineHandle

Type : _In_ HANDLE

Handle pour une session ouverte avec le moteur de filtre. Pour ouvrir une session avec le moteur de filtre, appelez FwpmEngineOpen0.

subscription

Structure FWPM_NET_EVENT_SUBSCRIPTION0 qui décrit les notifications qui seront remises.

callback

Pointeur vers une fonction de type FWPM_NET_EVENT_CALLBACK3, qui est appelée lorsqu’une notification est prête à être remise.

context

Pointeur de contexte facultatif. Ce pointeur est passé à la fonction de rappel avec les détails de l’événement.

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
ERROR_SUCCESS 0	L’abonnement a été créé avec succès.
code d’erreur FWP_E_* 0x80320001—0x80320039	Une erreur spécifique à la plateforme de filtrage Windows (PAM). Pour plus d’informations, consultez Codes d’erreur PAM.
code d’erreur RPC_* 0x80010001—0x80010122	Échec de la communication avec le moteur de pare-feu distant ou local.

Remarques

Vous ne pouvez pas appeler cette fonction dans une transaction. Elle échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.

Pour appeler cette fonction, vous devez accéder FWPM_ACTRL_SUBSCRIBE au conteneur de l’événement net.

Configuration requise

Condition requise	Valeur
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Partager via