Partager via


FwpmNetEventSubscribe0, fonction (fwpmu.h)

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

RemarqueFwpmNetEventSubscribe0 est l’implémentation spécifique de FwpmNetEventSubscribe utilisée dans Windows 7. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows 8, FwpmNetEventSubscribe1 est disponible.
 

Syntaxe

DWORD FwpmNetEventSubscribe0(
  [in]           HANDLE                             engineHandle,
  [in]           const FWPM_NET_EVENT_SUBSCRIPTION0 *subscription,
  [in]           FWPM_NET_EVENT_CALLBACK0           callback,
  [in, optional] void                               *context,
  [out]          HANDLE                             *eventsHandle
);

Paramètres

[in] engineHandle

Type : HANDLE

Handle pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.

[in] subscription

Type : FWPM_NET_EVENT_SUBSCRIPTION0*

Notifications qui seront remises.

[in] callback

Type : FWPM_NET_EVENT_CALLBACK0

Pointeur de fonction qui sera appelé lorsqu’une notification est prête à être remise.

[in, optional] context

Type : void*

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

[out] eventsHandle

Type : HANDLE*

Gérez l’abonnement nouvellement créé.

Valeur retournée

Type : DWORD

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

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête fwpmu.h
Bibliothèque Fwpuclnt.lib
DLL Fwpuclnt.dll

Voir aussi

FWPM_NET_EVENT_CALLBACK0

FWPM_NET_EVENT_SUBSCRIPTION0

FwpmNetEventUnsubscribe0