Fonction FwpmNetEventSubscribe2 (fwpmu.h)

Article
03/11/2023

La fonction FwpmNetEventSubscribe2 est utilisée pour demander la remise de notifications concernant un événement net particulier.

RemarqueFwpmNetEventSubscribe2 est l’implémentation spécifique de FwpmNetEventSubscribe utilisée dans Windows 10, version 1607 et ultérieures. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows 8, FwpmNetEventSubscribe1 est disponible. Pour Windows 7, FwpmNetEventSubscribe0 est disponible.

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

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

FWPM_NET_EVENT_CALLBACK2

FWPM_NET_EVENT_SUBSCRIPTION0

FwpmNetEventUnsubscribe0

Partager via