Fonction FwpmCalloutAdd0 (fwpmk.h)
La fonction FwpmCalloutAdd0 ajoute une légende au moteur de filtre.
Syntaxe
NTSTATUS FwpmCalloutAdd0(
[in] HANDLE engineHandle,
[in] const FWPM_CALLOUT0 *callout,
[in, optional] PSECURITY_DESCRIPTOR sd,
[out, optional] UINT32 *id
);
Paramètres
[in] engineHandle
Handle pour une session ouverte sur le moteur de filtre. Un pilote de légende appelle la fonction FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.
[in] callout
Pointeur vers une structure de FWPM_CALLOUT0 constante qui contient les données requises pour ajouter la légende au moteur de filtre.
[in, optional] sd
Pointeur vers une structure de SECURITY_DESCRIPTOR constante qui décrit le descripteur de sécurité pour la légende qui est ajoutée au moteur de filtre. Ce paramètre est facultatif et peut être NULL.
[out, optional] id
Pointeur vers une variable de type UINT32 qui reçoit un identificateur d’exécution qui identifie la légende dans le moteur de filtre. Il s’agit du même identificateur que celui qui est retourné lorsqu’un pilote de légende inscrit les fonctions de légende du pilote de légende auprès du moteur de filtre. Le pilote de légende transmet cet identificateur à la fonction FwpmCalloutDeleteById0 lors de la suppression de la légende du moteur de filtre. Ce paramètre est facultatif et peut être NULL.
Valeur retournée
La fonction FwpmCalloutAdd0 retourne l’un des codes NTSTATUS suivants :
| Code de retour | Description |
|---|---|
|
La légende a été correctement ajoutée au moteur de filtre. |
|
La légende n’a pas pu être ajoutée au moteur de filtre. Une légende existe déjà dans le moteur de filtre avec un identificateur identique au GUID spécifié dans le membre calloutKey de la structure FWPM_CALLOUT0 pointée par le paramètre de légende . |
|
Une erreur est survenue. |
Remarques
Un pilote de légende appelle la fonction FwpmCalloutAdd0 pour ajouter une légende au moteur de filtre.
Les pilotes de légende n’ajoutent généralement pas leurs légendes au moteur de filtre. Dans la plupart des cas, cela est géré par une application de gestion de la plateforme de filtrage Windows en mode utilisateur.
Une légende et des filtres qui spécifient la légende de l’action du filtre peuvent être ajoutés au moteur de filtre avant qu’un pilote de légende inscrive la légende auprès du moteur de filtre. Dans ce cas, les filtres avec un type d’action de FWP_ACTION_CALLOUT_TERMINATING ou de FWP_ACTION_CALLOUT_UNKNOWN sont traités comme des FWP_ACTION_BLOCK et les filtres avec un type d’action de FWP_ACTION_CALLOUT_INSPECTION sont ignorés jusqu’à ce que la légende soit inscrite auprès du moteur de filtre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows Vista. |
| Plateforme cible | Universal |
| En-tête | fwpmk.h (incluez Fwpmk.h) |
| Bibliothèque | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour