Fonction FwpmProviderContextSubscribeChanges0 (fwpmu.h)
La fonction FwpmProviderContextSubscribeChanges0 est utilisée pour demander la remise de notifications concernant des modifications dans un contexte de fournisseur particulier.
Syntaxe
DWORD FwpmProviderContextSubscribeChanges0(
[in] HANDLE engineHandle,
[in] const FWPM_PROVIDER_CONTEXT_SUBSCRIPTION0 *subscription,
[in] FWPM_PROVIDER_CONTEXT_CHANGE_CALLBACK0 callback,
[in, optional] void *context,
[out] HANDLE *changeHandle
);
Paramètres
[in] engineHandle
Type : HANDLE
Gérer pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in] subscription
Type : const FWPM_PROVIDER_CONTEXT_SUBSCRIPTION0*
Notifications à remettre.
[in] callback
Type : FWPM_PROVIDER_CONTEXT_CHANGE_CALLBACK0
Pointeur de fonction qui sera appelé lorsqu’une notification est prête pour la 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 |
|---|---|
|
L’abonnement a été créé avec succès. |
|
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
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. En effet, les abonnés n’ont besoin que de voir les modifications apportées par d’autres utilisateurs, car ils savent déjà quelles modifications ils ont elles-mêmes apportées.
Cette fonction ne peut pas être appelée à partir d’une transaction. Il échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez Gestion des objets.
L’appelant a besoin FWPM_ACTRL_SUBSCRIBE accès au conteneur du contexte du fournisseur et FWPM_ACTRL_READ d’accès au contexte du fournisseur. L’abonné recevra uniquement des notifications pour les contextes de fournisseur auxquels il a FWPM_ACTRL_READ accès. Pour plus d’informations, consultez Access Control.
FwpmProviderContextSubscribeChanges0 est une implémentation spécifique de FwpmProviderContextSubscribeChanges. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de 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 |