FwpmNetEventEnum1, fonction (fwpmu.h)

Article
06/27/2024

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

RemarqueFwpmNetEventEnum1 est l’implémentation spécifique de FwpmNetEventEnum utilisée dans Windows 7 et versions ultérieures. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows. Pour Windows 8, FwpmNetEventEnum2 est disponible. Pour Windows Vista, FwpmNetEventEnum0 est disponible.

Syntaxe

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

Paramètres

[in] engineHandle

Type : HANDLE

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

[in] enumHandle

Type : HANDLE

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

[in] numEntriesRequested

Type : UINT32

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

[out] entries

Type : FWPM_NET_EVENT1***

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

[out] numEntriesReturned

Type : UINT32*

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

Valeur de retour

Type : DWORD

Retourner le code/la valeur	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	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.

Remarques

Si la numEntriesReturned est inférieure à la 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 figurant dans les entrées de actuelles tampon.

FwpmNetEventEnum1 retourne uniquement les événements enregistrés avant la création du paramètre enumHandle. Pour plus d’informations, consultez de journalisation.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	fwpmu.h
bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

FWPM_NET_EVENT1

FwpmNetEventCreateEnumHandle0

de journalisation PAM

Partager via