Fonction FwpmCalloutDeleteByKey0 (fwpmu.h)
La fonction FwpmCalloutDeleteByKey0 supprime un objet de légende du système.
Syntaxe
DWORD FwpmCalloutDeleteByKey0(
[in] HANDLE engineHandle,
[in] const GUID *key
);
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] key
Type : const GUID*
Identificateur unique de la légende supprimée du système. Ce GUID a été spécifié dans le membre calloutKey du paramètre de légende lorsque l’application a appelé FwpmCalloutAdd0 pour cet objet.
Valeur retournée
Type : DWORD
| Code/valeur de retour | Description |
|---|---|
|
La légende a été supprimée 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. |
Notes
Les légendes d’une application ne peuvent pas être supprimées du système tant qu’il existe des filtres dans le système qui spécifient les légendes d’une action.
Cette fonction ne peut pas être appelée à partir d’une transaction en lecture seule. Elle échoue avec FWP_E_INCOMPATIBLE_TXN. Pour plus d’informations sur les transactions, consultez Gestion des objets.
Cette fonction peut être appelée dans une session dynamique si l’objet correspondant a été ajouté au cours de la même session. Si cette fonction est appelée pour un objet qui a été ajouté au cours d’une autre session dynamique, elle échoue avec FWP_E_WRONG_SESSION. Si cette fonction est appelée pour un objet qui n’a pas été ajouté pendant une session dynamique, elle échoue avec FWP_E_DYNAMIC_SESSION_IN_PROGRESS.
L’appelant a besoin d’un accès DELETE à la légende. Pour plus d’informations, consultez Access Control.
FwpmCalloutDeleteByKey0 est une implémentation spécifique de FwpmCalloutDeleteByKey. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of 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 |