Partager via


Fonction FwpmSubLayerSubscribeChanges0 (fwpmu.h)

La fonction FwpmSubLayerSubscribeChanges0 est utilisée pour demander la remise de notifications concernant les modifications apportées à une sous-couche particulière.

Syntaxe

DWORD FwpmSubLayerSubscribeChanges0(
  [in]           HANDLE                            engineHandle,
  [in]           const FWPM_SUBLAYER_SUBSCRIPTION0 *subscription,
  [in]           FWPM_SUBLAYER_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 : FWPM_SUBLAYER_SUBSCRIPTION0*

Notifications à remettre.

[in] callback

Type : FWPM_SUBLAYER_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
ERROR_SUCCESS
0
L’abonnement a été créé avec succès.
code d’erreur FWP_E_*
0x80320001 0x80320039
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.

Notes

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 de la sous-couche et FWPM_ACTRL_READ accès à la sous-couche. L’abonné recevra uniquement des notifications pour les sous-couches auxquelles il a FWPM_ACTRL_READ accès. Pour plus d’informations, consultez Access Control.

FwpmSubLayerSubscribeChanges0 est une implémentation spécifique de FwpmSubLayerSubscribeChanges. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .

Spécifications

   
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_SUBLAYER_CHANGE_CALLBACK0

FWPM_SUBLAYER_SUBSCRIPTION0