Fonction FwpmProviderContextGetById3 (fwpmu.h)

Récupère un contexte de fournisseur.

Syntaxe

DWORD FwpmProviderContextGetById3(
  HANDLE                 engineHandle,
  UINT64                 id,
  FWPM_PROVIDER_CONTEXT3 **providerContext
);

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.

id

Type : _In_ UINT64

providerContext

Objet de contexte de fournisseur à ajouter.

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	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.

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

Pour appeler cette fonction, vous devez accéder FWPM_ACTRL_READ au contexte du fournisseur. Pour plus d’informations, consultez Contrôle d’accès.