Partager via

FwpmNetEventEnum2, fonction (fwpmk.h)

  • Article

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

Syntaxe

NTSTATUS FwpmNetEventEnum2(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT2 ***entries,
  [out] UINT32          *numEntriesReturned
);

Paramètres

[in] engineHandle

Gérer une session ouverte sur le moteur de filtre. Appelez FwpmEngineOpen0 pour ouvrir une session au 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 de retour

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.
autres codes NTSTATUS Une erreur s’est produite.

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

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

FwpmNetEventEnum2 est une implémentation spécifique de FwpmNetEventEnum. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Exigences

Exigence Valeur
client minimum pris en charge Disponible à partir de Windows Vista.
plateforme cible Universel
d’en-tête fwpmk.h
bibliothèque fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Voir aussi