IPsecSaContextCreateEnumHandle0-Funktion (fwpmu.h)

Die IPsecSaContextCreateEnumHandle0-Funktion erstellt ein Handle, das zum Aufzählen einer Reihe von IPsec-Sicherheitszuordnungskontextobjekten (SA) verwendet wird.

Syntax

DWORD IPsecSaContextCreateEnumHandle0(
  [in]           HANDLE                                engineHandle,
  [in, optional] const IPSEC_SA_CONTEXT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                                *enumHandle
);

Parameter

[in] engineHandle

Typ: HANDLE

Handle für eine geöffnete Sitzung für die Filter-Engine. Rufen Sie FwpmEngineOpen0 auf, um eine Sitzung für die Filter-Engine zu öffnen.

[in, optional] enumTemplate

Typ: const IPSEC_SA_CONTEXT_ENUM_TEMPLATE0*

Vorlage zum selektiven Einschränken der Enumeration.

[out] enumHandle

Typ: HANDLE*

Adresse einer HANDLE-Variablen . Bei der Funktionsrückgabe enthält es das Handle für die SA-Kontextaufzählung.

Rückgabewert

Art: DWORD

Hinweise

Wenn enumTemplateNULL ist, werden alle IPsec SA-Objekte zurückgegeben.

Der Aufrufer muss IPsecSaContextDestroyEnumHandle0 aufrufen, um das zurückgegebene Handle freizugeben.

Der Aufrufer benötigt FWPM_ACTRL_ENUM und FWPM_ACTRL_READ Zugriff auf die IPsec-Sicherheitszuordnungsdatenbank. Weitere Informationen finden Sie unter Access Control.

IPsecSaContextCreateEnumHandle0 ist eine spezifische Implementierung von IPsecSaContextCreateEnumHandle. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Anforderungen

Weitere Informationen

IPSEC_SA_CONTEXT_ENUM_TEMPLATE0

IPsecSaContextDestroyEnumHandle0