Fonction FwpmProviderContextAdd3 (fwpmu.h)

Article
05/03/2024

Ajoute un nouveau contexte de fournisseur au système.

Syntaxe

DWORD FwpmProviderContextAdd3(
  HANDLE                       engineHandle,
  const FWPM_PROVIDER_CONTEXT3 *providerContext,
  PSECURITY_DESCRIPTOR         sd,
  UINT64                       *id
);

Paramètres

engineHandle

Type : _in_ HANDLE

Handle pour une session ouverte avec le moteur de filtre. Pour ouvrir une session avec le moteur de filtre, appelez FwpmEngineOpen0.

providerContext

Type : _In_ FWPM_PROVIDER_CONTEXT3*

Objet de contexte de fournisseur à ajouter.

sd

Type : _In_opt_ PSECURITY_DESCRIPTOR

Informations de sécurité facultatives associées à l’objet de contexte du fournisseur.

id

Type : _Out_opt_ UINT64*

Pointeur vers une variable qui reçoit un identificateur d’exécution pour ce contexte de fournisseur.

Valeur retournée

Type : DWORD*

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le contexte du fournisseur a été ajouté avec succès.
ERROR_NOT_SUPPORTED 0x32	Les FWPM_IPSEC_IKE_MM_CONTEXT et la méthode d’authentification IKEEXT_IPV6_CGA se trouvent dans le tableau authenticationMethods , mais l’adresse générée par chiffrement (CGA) n’est pas activée dans le Registre.
code d’erreur FWP_E_* 0x80320001 0x80320039	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_PROVIDER_CONTEXT2 sont attribués par le système, et non par l’appelant, et sont ignorés dans l’appel à FwpmProviderContextAdd3.

Si vous fournissez un descripteur de sécurité NULL , le système affectera un descripteur de sécurité par défaut.

Vous ne pouvez pas appeler cette fonction dans une transaction en lecture seule. Elle échoue avec FWP_E_INCOMPATIBLE_TXN. Pour plus d’informations sur les transactions, consultez Gestion des objets.

Pour appeler cette fonction, vous devez FWPM_ACTRL_ADD accès au conteneur du contexte du fournisseur et FWPM_ACTRL_ADD_LINK accès au fournisseur (le cas échéant). Pour plus d’informations, consultez Contrôle d’accès.

Configuration requise

Condition requise	Valeur
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Partager via