Partager via

FwpmProviderContextGetByKey3, fonction (fwpmk.h)

  • Article

La fonction FwpmProviderContextGetByKey3 récupère un contexte de fournisseur.

Syntaxe

NTSTATUS FwpmProviderContextGetByKey3(
  [in] HANDLE                 engineHandle,
       const GUID             *key,
       FWPM_PROVIDER_CONTEXT3 **providerContext
);

Paramètres

[in] engineHandle

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

key

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 spécifié lorsque l’application appelée FwpmProviderContextAdd3 pour cet objet.

providerContext

Informations de contexte du fournisseur.

Valeur de retour

Retourner le code/la valeur 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). 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

L’appelant doit libérer l’objet retourné par un appel à FwpmFreeMemory0.

L’appelant doit FWPM_ACTRL_READ'accès au contexte du fournisseur. Pour plus d’informations, consultez contrôle d’accès.

FwpmProviderContextGetByKey0 est une implémentation spécifique de FwpmProviderContextGetByKey. 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

Voici tous les liens du document actif :