Fonction FwpmProviderSubscribeChanges0 (fwpmu.h)

Article
02/26/2024

La fonction FwpmProviderSubscribeChanges0 est utilisée pour demander la remise de notifications concernant les modifications apportées à un fournisseur particulier.

Syntaxe

DWORD FwpmProviderSubscribeChanges0(
  [in]           HANDLE                            engineHandle,
  [in, optional] const FWPM_PROVIDER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_PROVIDER_CHANGE_CALLBACK0    callback,
  [in, optional] void                              *context,
  [out]          HANDLE                            *changeHandle
);

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, optional] subscription

Type : FWPM_PROVIDER_SUBSCRIPTION0*

Notifications à remettre.

[in] callback

Type : FWPM_PROVIDER_CHANGE_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 la modification.

[out] changeHandle

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

Les abonnés ne reçoivent pas de notifications pour les modifications apportées avec le même handle de session que celui utilisé pour s’abonner. Cela est dû au fait que les abonnés ont uniquement besoin de voir les modifications apportées par d’autres utilisateurs, car ils savent déjà quelles modifications ils ont elles-mêmes effectuées.

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 du fournisseur et d’un accès FWPM_ACTRL_READ au fournisseur. L’abonné recevra uniquement des notifications pour les fournisseurs auxquels il a FWPM_ACTRL_READ accès. Pour plus d’informations, consultez Access Control.

FwpmProviderSubscribeChanges0 est une implémentation spécifique de FwpmProviderSubscribeChanges. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Configuration requise

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

Voir aussi

FWPM_PROVIDER_CHANGE_CALLBACK0

FWPM_PROVIDER_SUBSCRIPTION0

Partager via