Fonction IkeextSaEnum1 (fwpmu.h)

Article
02/27/2024

La fonction IkeextSaEnum1 retourne la page suivante des résultats de l’énumérateur d’association de sécurité IKE/AuthIP (SA).

RemarqueIkeextSaEnum1 est l’implémentation spécifique d’IkeextSaEnum utilisée dans Windows 7. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows . Pour Windows 8, IkeextSaEnum2 est disponible. Pour Windows Vista, IkeextSaEnum0 est disponible.

Syntaxe

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

Paramètres

[in] engineHandle

Type : HANDLE

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

[in] enumHandle

Type : HANDLE

Handle pour une énumération SA IKE/AuthIP. Appelez IkeextSaCreateEnumHandle0 pour obtenir un handle d’énumération.

[in] numEntriesRequested

Type : UINT32

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

[out] entries

Type : IKEEXT_SA_DETAILS1***

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

[out] numEntriesReturned

Type : UINT32*

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

Valeur retournée

Type : DWORD

Code/valeur de retour	Description
ERROR_SUCCESS 0	Les autorités de sécurité ont été énumérées avec succès.
code d’erreur FWP_E_* 0x80320001 0x80320039	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.

Remarques

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 utilisant le même handle d’énumération retourne l’ensemble d’éléments suivant ceux du dernier tampon de sortie.

IkeextSaEnum1 fonctionne sur une instantané des autorités de sécurité prises au moment de la création du handle d’énumération.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fwpmu.h
Bibliothèque	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Voir aussi

Fonctions IKE/AuthIP

IKEEXT_SA_DETAILS0

Fonctions pam

Partager via