Fonction FwpmCalloutDeleteById0 (fwpmu.h)

Article
08/23/2023

La fonction FwpmCalloutDeleteById0 supprime un objet de légende du système.

Syntaxe

DWORD FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

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] id

Type : UINT32

Identificateur d’exécution de la légende en cours de suppression du système. Cet identificateur a été reçu du système lorsque l’application a appelé FwpmCalloutAdd0 pour cet objet.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	La légende a été supprimée.
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.

Notes

Les légendes d’une application ne peuvent pas être supprimées du système tant qu’il existe dans le système des filtres 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.

FwpmCalloutDeleteById0 est une implémentation spécifique de FwpmCalloutDeleteById. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de 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

Voir aussi

FwpmCalloutAdd0

FwpmCalloutDeleteById0 en mode noyau

Partager via