Fonction FwpmProviderContextEnum0 (fwpmu.h)

Article
08/23/2023

La fonction FwpmProviderContextEnum0 retourne la page suivante des résultats de l’énumérateur de contexte du fournisseur.

RemarqueFwpmProviderContextEnum0 est l’implémentation spécifique de FwpmProviderContextEnum utilisée dans Windows Vista. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows . Pour Windows 7, FwpmProviderContextEnum1 est disponible. Pour Windows 8, FwpmProviderContextEnum2 est disponible.

Syntaxe

DWORD FwpmProviderContextEnum0(
  [in]  HANDLE                 engineHandle,
  [in]  HANDLE                 enumHandle,
  [in]  UINT32                 numEntriesRequested,
  [out] FWPM_PROVIDER_CONTEXT0 ***entries,
  [out] UINT32                 *numEntriesReturned
);

Paramètres

[in] engineHandle

Type : HANDLE

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

[in] enumHandle

Type : HANDLE

Handle pour une énumération de contexte de fournisseur créée par un appel à FwpmProviderContextCreateEnumHandle0.

[in] numEntriesRequested

Type : UINT32

Nombre d’objets de contexte de fournisseur demandés.

[out] entries

Type : FWPM_PROVIDER_CONTEXT0***

Objets de contexte de fournisseur retournés.

[out] numEntriesReturned

Type : UINT32*

Nombre d’objets de contexte de fournisseur retournés.

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Les contextes du fournisseur ont été énumérés 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.

Notes

Si numEntriesReturned est inférieur à numEntriesRequested, l’énumération est épuisée.

Le tableau d’entrées retourné (mais pas les entrées individuelles elles-mêmes) doit être libéré par un appel à FwpmFreeMemory0.

Un appel suivant utilisant le même handle d’énumération retourne l’ensemble d’éléments suivant ceux du dernier tampon de sortie.

FwpmProviderContextEnum0 fonctionne sur un instantané des contextes de fournisseur pris au moment de la création du handle d’énumération.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

FWPM_PROVIDER_CONTEXT0

FwpmProviderContextCreateEnumHandle0

Partager via