Partager via

FwpmNetEventCreateEnumHandle0, fonction (fwpmk.h)

  • Article

La fonction FwpmNetEventCreateEnumHandle0 crée un handle utilisé pour énumérer un ensemble d’événements réseau.

Syntaxe

NTSTATUS FwpmNetEventCreateEnumHandle0(
  [in]           HANDLE                              engineHandle,
  [in, optional] const FWPM_NET_EVENT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                              *enumHandle
);

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, optional] enumTemplate

Modèle pour restreindre sélectivement l’énumération.

[out] enumHandle

Handle pour l’énumération d’événements réseau.

Valeur de retour

Retourner le code/la valeur Description
ERROR_SUCCESS
0		 L’énumérateur a été créé avec succès.
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 énumération est NULL, tous les objets d’événement réseau sont retournés.

L’appelant doit appeler FwpmNetEventDestroyEnumHandle0 pour libérer le handle retourné.

Cette fonction ne peut pas être appelée à partir d’une transaction, elle échoue avec FWP_E_TXN_IN_PROGRESS. Pour plus d’informations sur les transactions, consultez gestion des objets.

L’appelant a besoin de FWPM_ACTRL_ENUM'accès aux conteneurs des événements. Pour plus d’informations, consultez contrôle d’accès.

FwpmNetEventCreateEnumHandle0 est une implémentation spécifique de FwpmNetEventCreateEnumHandle. 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