Fonction IPsecSaContextUnsubscribe0 (fwpmu.h)

La fonction IPsecSaContextUnsubscribe0 permet d’annuler un abonnement de modification d’association de sécurité (SA) IPsec et d’arrêter de recevoir des notifications de modification.

Syntaxe

DWORD IPsecSaContextUnsubscribe0(
  [in]      HANDLE engineHandle,
  [in, out] HANDLE eventsHandle
);

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

Type : HANDLE

Handle de la notification de modification DE SA abonnée. Il s’agit du handle retourné par l’appel à IPsecSaContextSubscribe0.

Il peut s’agir de NULL, auquel cas la fonction n’aura aucun effet.

Valeur retournée

Type : DWORD

Notes

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.

Spécifications