Fonction FwpmNetEventEnum5 (fwpmu.h)

Article
05/03/2024

Récupère la page de résultats suivante de l’énumérateur d’événements réseau.

Syntaxe

DWORD FwpmNetEventEnum5(
  HANDLE          engineHandle,
  HANDLE          enumHandle,
  UINT32          numEntriesRequested,
  FWPM_NET_EVENT5 ***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 à FwpmNetEventCreateEnumHandle0.

numEntriesRequested

Type : _In_ UINT32

Nombre d’entrées d’énumération demandées.

entries

Type : _Outptr_result_buffer_(*numEntriesReturned) const FWPM_NET_EVENT5***

Adresses des entrées d’énumération.

numEntriesReturned

Type : _Out_ UINT32*

Nombre d’entrées d’énumération retournées.

Valeur retournée

Code/valeur de retour	Description
ERROR_SUCCESS 0	Les événements réseau ont été énumérés avec succès.
FWP_E_NET_EVENTS_DISABLED 0x80320013	La collection d’événements de diagnostic réseau est désactivée.
Appelez FwpmEngineSetOption0 pour l’activer.
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.

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 de la mémoire tampon des entrées actuelles.

FwpmNetEventEnum5 retourne uniquement les événements qui ont été enregistrés avant la création du paramètre enumHandle . Pour plus d’informations, consultez Journalisation.

Configuration requise

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

Partager via