Fonction FwpmSubLayerUnsubscribeChanges0 (fwpmu.h)
La fonction FwpmSubLayerUnsubscribeChanges0 permet d’annuler un abonnement de modification de sous-couche et d’arrêter de recevoir des notifications de modification.
Syntaxe
DWORD FwpmSubLayerUnsubscribeChanges0(
[in] HANDLE engineHandle,
[in] 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] changeHandle
Type : HANDLE
Handle de la notification de modification souscrite. Il s’agit du handle retourné par l’appel à FwpmSubLayerSubscribeChanges0.
Valeur retournée
Type : DWORD
| Code/valeur de retour | Description |
|---|---|
|
L’abonnement a été supprimé avec succès. |
|
Une 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
Si le rappel est en cours d’appel, cette fonction ne sera pas retournée tant qu’elle n’est pas terminée. Ainsi, lors de l’appel de cette fonction, vous ne devez pas contenir de verrous que le rappel peut également essayer d’acquérir de peur que vous ne vous interblocez.
Il n’est pas nécessaire de se désabonner avant de fermer une session ; tous les abonnements sont automatiquement annulés à la fin de la session d’abonnement.
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.
FwpmSubLayerUnsubscribeChanges0 est une implémentation spécifique de FwpmSubLayerUnsubscribeChanges. 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 |