Fonction FwpmSystemPortsUnsubscribe0 (fwpmu.h)

La fonction FwpmSystemPortsUnsubscribe0 est utilisée pour annuler un abonnement au port système et arrêter de recevoir des notifications.

Syntaxe

DWORD FwpmSystemPortsUnsubscribe0(
  [in, optional] HANDLE engineHandle,
  [in, out]      HANDLE sysPortsHandle
);

Paramètres

[in, optional] 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] sysPortsHandle

Type : HANDLE

Gérer la notification de port système abonné. Il s’agit du handle retourné par l’appel à FwpmSystemPortsSubscribe0.

Valeur retournée

Type : DWORD

Notes

La désinscription avec un handle d’objet non valide entraîne une valeur de retour de ERROR_SUCCESS, mais l’abonnement réel persiste jusqu’à ce que l’API de désinscription soit appelée avec des paramètres valides.

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.

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

Spécifications

Voir aussi

FwpmSystemPortsSubscribe0