Partager via

FwpmProviderAdd0, fonction (fwpmk.h)

  • Article

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

Syntaxe

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

Paramètres

[in] engineHandle

Gérer une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session au moteur de filtre.

[in] provider

Objet fournisseur à ajouter.

[in, optional] sd

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

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 Le fournisseur a été ajouté avec succès.
code d’erreur FWP_E_*
0x80320001 — 0x80320039		 Erreur spécifique à la plateforme de filtrage Windows (PAM). Consultez codes d’erreur PAM pour plus d’informations.
code d’erreur RPC_*
0x80010001 — 0x80010122		 Échec de la communication avec le moteur de pare-feu distant ou local.
autres codes NTSTATUS Une erreur s’est produite.

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 de 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 terminée par le BFE. 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 possède ensuite l’objet de stratégie persistante. Au début, le BFE ajoute uniquement les types d’objets persistants suivants 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 le 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 de FWPM_ACTRL_ADD'accès au conteneur du fournisseur. Pour plus d’informations, consultez contrôle d’accès.

FwpmProviderAdd0 est une implémentation spécifique de FwpmProviderAdd. 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
bibliothèque fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi