Partager via


FwpmProviderContextCreateEnumHandle0, fonction (fwpmk.h)

La fonction FwpmProviderContextCreateEnumHandle0 crée un handle utilisé pour énumérer un ensemble de contextes de fournisseur.

Syntaxe

NTSTATUS FwpmProviderContextCreateEnumHandle0(
  [in]           HANDLE                                     engineHandle,
  [in, optional] const FWPM_PROVIDER_CONTEXT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                     *enumHandle
);

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, optional] enumTemplate

Modèle pour restreindre sélectivement l’énumération.

[out] enumHandle

Gérer l’énumération de contexte du fournisseur.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0
L’énumérateur a été créé 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 énumération est NULL, tous les contextes du fournisseur sont retournés.

L’énumérateur n’est pas actif, ce qui signifie qu’il ne reflète pas les modifications apportées au système après l’appel à FwpmProviderContextCreateEnumHandle0 retourne. Si vous devez vous assurer que les résultats sont actuels, vous devez appeler FwpmProviderContextCreateEnumHandle0 et FwpmProviderContextEnum0 à partir de la même transaction explicite.

L’appelant doit libérer le handle retourné par un appel à FwpmProviderContextDestroyEnumHandle0.

L’appelant doit FWPM_ACTRL_ENUM'accès aux conteneurs des contextes du fournisseur et FWPM_ACTRL_READ l’accès aux contextes du fournisseur. Seuls les contextes de fournisseur auxquels l’appelant a FWPM_ACTRL_READ accès sont retournés. Pour plus d’informations, consultez contrôle d’accès.

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