Fonction FwpmCalloutAdd0 (fwpmu.h)

Article
02/28/2024

La fonction FwpmCalloutAdd0 ajoute un nouvel objet de légende au système.

Syntaxe

DWORD FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

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

Type : FWPM_CALLOUT0*

Objet de légende à ajouter.

[in, optional] sd

Type : PSECURITY_DESCRIPTOR

Informations de sécurité associées à la légende.

[out, optional] id

Type : UINT32*

Identificateur d’exécution pour cette légende.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	La légende a été correctement ajoutée.
FWP_E_INVALID_PARAMETER 0x80320035	FWPM_TUNNEL_FLAG_POINT_TO_POINT n’a pas été défini et des conditions autres que l’adresse locale/distante ont été spécifiées.
code d’erreur FWP_E_* 0x80320001—0x80320039	Une 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.

Remarques

Certains champs de la structure FWPM_CALLOUT0 sont attribués par le système, et non par l’appelant, et sont ignorés dans l’appel à FwpmCalloutAdd0. Si l’appelant fournit un descripteur de sécurité Null, le système affecte un descripteur de sécurité par défaut.

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.

L’appelant doit accéder FWPM_ACTRL_ADD au conteneur de la légende, FWPM_ACTRL_ADD_LINK accès au fournisseur (le cas échéant) et FWPM_ACTRL_ADD_LINK accès à la couche applicable. Pour plus d’informations, consultez Access Control.

Pour ajouter un filtre qui référence une légende, appelez les fonctions dans l’ordre suivant.

Appelez FwpsCalloutRegister (documenté dans le Kit de pilotes Windows (WDK)) pour inscrire la légende auprès du moteur de filtre.
Appelez FwpmCalloutAdd0 pour ajouter la légende au système.
Appelez FwpmFilterAdd0 pour ajouter le filtre qui référence la légende au système.

Par défaut, les filtres qui font référence à des légendes qui ont été ajoutées mais qui n’ont pas encore été inscrites auprès du moteur de filtre sont traités comme des filtres de bloc.

FwpmCalloutAdd0 est une implémentation spécifique de FwpmCalloutAdd. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Configuration requise

Condition requise	Valeur
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

FWPM_CALLOUT0

FwpmCalloutAdd0 en mode noyau

Partager via