Fonction FwpmProviderAdd0 (fwpmu.h)

Article
08/23/2023

La fonction FwpmProviderAdd0 ajoute un nouveau fournisseur au système.

Syntaxe

DWORD FwpmProviderAdd0(
  [in]           HANDLE               engineHandle,
  [in]           const FWPM_PROVIDER0 *provider,
  [in, optional] PSECURITY_DESCRIPTOR sd
);

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

Type : FWPM_PROVIDER0*

Objet fournisseur à ajouter.

[in, optional] sd

Type : PSECURITY_DESCRIPTOR

Informations de sécurité pour l’objet fournisseur.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le fournisseur a été correctement ajouté.
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

Si l’appelant fournit un descripteur de sécurité Null, le système affecte un descripteur de sécurité par défaut.

Les objets au moment du démarrage sont ajoutés au moteur de filtrage de base (BFE) au démarrage du pilote TCP/IP et sont supprimés une fois l’initialisation du BFE terminée. Les objets persistants sont ajoutés au démarrage du BFE. Si un fournisseur de stratégie a une stratégie persistante qui n’est pas destinée à être appliquée si son service associé est désactivé, l’appelant peut spécifier un nom de service facultatif dans la structure FWPM_PROVIDER0 . Ce service est alors propriétaire de l’objet de stratégie persistant. Au début, le BFE ajoute uniquement les types suivants d’objets persistants au système.

L’objet n’est pas associé à un fournisseur.
L’objet a un fournisseur associé qui ne spécifie pas de nom de service.
L’objet a un fournisseur associé et un service associé défini sur démarrage automatique.

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 a besoin d’un accès FWPM_ACTRL_ADD au conteneur du fournisseur. Pour plus d’informations, consultez Access Control.

FwpmProviderAdd0 est une implémentation spécifique de FwpmProviderAdd. 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_PROVIDER0

Partager via