Fonction FwpmProviderContextEnum3 (fwpmu.h)

Article
05/03/2024

Retourne la page suivante des résultats de l’énumérateur de contexte du fournisseur.

Syntaxe

DWORD FwpmProviderContextEnum3(
  HANDLE                 engineHandle,
  HANDLE                 enumHandle,
  UINT32                 numEntriesRequested,
  FWPM_PROVIDER_CONTEXT3 ***entries,
  UINT32                 *numEntriesReturned
);

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.

enumHandle

Type : _in_ HANDLE

Handle d’une énumération d’événements réseau créée par un appel à FwpmProviderContextCreateEnumHandle0.

numEntriesRequested

Type : _In_ UINT32

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

entries

Type : _Outptr_result_buffer_(*numEntriesReturned) FWPM_PROVIDER_CONTEXT3***

Objets de contexte de fournisseur retournés.

numEntriesReturned

Type : _Out_ 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.

Remarques

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

Vous devez libérer le tableau d’entrées retourné (mais pas les entrées individuelles elles-mêmes) en appelant FwpmFreeMemory0.

Un appel suivant qui utilise le même paramètre enumHandle retourne le jeu d’événements suivant ceux du dernier tampon de sortie.

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

Configuration requise

Condition requise	Valeur
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Partager via