FwpmCalloutAdd0, fonction (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 au 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 SECURITY_DESCRIPTOR constante qui décrit le descripteur de sécurité pour la légende ajoutée au moteur de filtre. Ce paramètre est facultatif et peut être NULL.
[out, optional] id
Pointeur vers une variable typée 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 retourné lorsqu’un pilote de légende inscrit les fonctions de légende du pilote de légende avec le 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 de retour
La fonction FwpmCalloutAdd0 retourne l’un des codes NTSTATUS suivants :
| Retourner le code | Description |
|---|---|
| STATUS_SUCCESS | La légende a été ajoutée au moteur de filtre. |
| STATUS_FWP_ALREADY_EXISTS | Impossible d’ajouter la légende 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 de légende de la structure FWPM_CALLOUT0 pointée par le paramètre de légende . |
| autres codes NTSTATUS | Une erreur s’est produite. |
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 enregistre 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 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.
FwpmCalloutAdd0 est une version spécifique de FwpmCalloutAdd. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows Vista. |
| plateforme cible | Universel |
| d’en-tête | fwpmk.h (include Fwpmk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |