Partager via


Fonction IPsecSaContextEnum0 (fwpmu.h)

La fonction IPsecSaContextEnum0 retourne la page suivante des résultats de l’énumérateur de contexte d’association de sécurité (SA) IPsec.

RemarqueIPsecSaContextEnum0 est l’implémentation spécifique d’IPsecSaContextEnum utilisée dans Windows Vista. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows . Pour Windows 7 et versions ultérieures, IPsecSaContextEnum1 est disponible.
 

Syntaxe

DWORD IPsecSaContextEnum0(
  [in]  HANDLE            engineHandle,
  [in]  HANDLE            enumHandle,
  [in]  UINT32            numEntriesRequested,
  [out] IPSEC_SA_CONTEXT0 ***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 de contexte SAP retournée par IPsecSaContextCreateEnumHandle0.

[in] numEntriesRequested

Type : UINT32

Nombre de contextes d’accès partagé demandés.

[out] entries

Type : IPSEC_SA_CONTEXT0***

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

[out] numEntriesReturned

Type : UINT32*

Nombre de contextes d’accès partagé retournés.

Valeur retournée

Type : DWORD

Code/valeur de retour Description
ERROR_SUCCESS
0
Les contextes SA IPsec ont été énumérés 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.

Notes

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.

Spécifications

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

Voir aussi

IPSEC_SA_CONTEXT0

IPsecSaContextCreateEnumHandle0