Fonction FwpmNetEventEnum3 (fwpmu.h)

Article
08/23/2023

La fonction FwpmNetEventEnum3 retourne la page suivante des résultats de l’énumérateur d’événements réseau.

Notezque FwpmNetEventEnum3 est l’implémentation spécifique de FwpmNetEventEnum utilisée dans Windows 10, version 1607 et ultérieures. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows . Pour Windows 8, FwpmNetEventEnum2 est disponible. Pour Windows 7, FwpmNetEventEnum1 est disponible. Pour Windows Vista, FwpmNetEventEnum0 est disponible.

Syntaxe

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

Paramètres

[in] engineHandle

Handle pour une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session sur le moteur de filtre.

[in] enumHandle

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

[in] numEntriesRequested

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

[out] entries

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

[out] numEntriesReturned

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.

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 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.

FwpmNetEventEnum3 retourne uniquement les événements enregistrés avant la création du paramètre enumHandle . Pour plus d’informations, voir Journalisation.

Spécifications


Client minimal pris en charge	Windows 10, version 1607 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

FWPM_NET_EVENT3

FwpmNetEventCreateEnumHandle0

Journalisation PAM

Partager via