Partager via

FwpmConnectionCreateEnumHandle0, fonction (fwpmk.h)

  • Article

La fonction FwpmConnectionCreateEnumHandle0 crée un handle utilisé pour énumérer un ensemble d’objets de connexion.

Syntaxe

NTSTATUS FwpmConnectionCreateEnumHandle0(
  [in]           HANDLE                               engineHandle,
  [in, optional] const FWPM_CONNECTION_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 de restriction sélective de l’énumération.

[out] enumHandle

Adresse d’une variable HANDLE HANDLE. Lors du retour de la fonction, il contient le handle de l’énumération.

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 de connexion sont retournés.

L’appelant doit libérer le handle retourné par un appel à FwpmConnectionDestroyEnumHandle0.

L’appelant doit FWPM_ACTRL_ENUM accéder aux conteneurs des objets de connexion et FWPM_ACTRL_READ l’accès aux objets de connexion. Pour plus d’informations, consultez contrôle d’accès.

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