Fonction FwpmvSwitchEventUnsubscribe0 (fwpmu.h)

  • Article

La fonction FwpmvSwitchEventUnsubscribe0 est utilisée pour annuler un abonnement à un événement vSwitch et arrêter de recevoir des notifications.

Syntaxe

DWORD FwpmvSwitchEventUnsubscribe0(
  [in]      HANDLE engineHandle,
  [in, out] HANDLE subscriptionHandle
);

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, out] subscriptionHandle

Type : HANDLE

Gérer la notification d’événement abonné. Il s’agit du handle retourné par l’appel à FwpmvSwitchEventSubscribe0.

Cela peut être NULL, auquel cas la fonction n’aura aucun effet.

Valeur retournée

Type : DWORD

Code/valeur de retour Description
ERROR_SUCCESS
0
 L’abonnement a été supprimé 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.

Remarques

Si le rappel est en cours d’appel, cette fonction ne sera pas retournée tant qu’elle ne sera 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 sorte 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 lorsque la session d’abonnement se termine.

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.

FwpmvSwitchEventUnsubscribe0 est une implémentation spécifique de FwpmvSwitchEventUnsubscribe. 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 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête fwpmu.h
Bibliothèque Fwpuclnt.lib
DLL Fwpuclnt.dll

Voir aussi

FwpmvSwitchEventSubscribe0

Fonctions pam