Fonction FwpmProviderContextGetByKey3 (fwpmu.h)

Article
05/03/2024

Récupère un contexte de fournisseur.

Syntaxe

DWORD FwpmProviderContextGetByKey3(
  HANDLE                 engineHandle,
  const GUID             *key,
  FWPM_PROVIDER_CONTEXT3 **providerContext
);

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.

key

Type : _In_ guid const *

Pointeur vers un GUID qui identifie de manière unique le contexte du fournisseur. Il s’agit d’un pointeur vers le MÊME GUID que celui spécifié lorsque votre application a appelé FwpmProviderContextAdd3 pour cet objet.

providerContext

Type : _Outptr_ FWPM_PROVIDER_CONTEXT3**

Informations de contexte du fournisseur.

Valeur retournée

Type : DWORD*

Code/valeur de retour	Description
ERROR_SUCCESS 0	Le contexte du fournisseur a été récupéré avec succès.
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

Vous devez libérer l’objet retourné en appelant FwpmFreeMemory0.

Pour appeler cette fonction, vous devez avoir FWPM_ACTRL_READ accès au contexte du fournisseur. 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