IPsecSaContextCreateEnumHandle0-Funktion (fwpmk.h)

Die IPsecSaContextCreateEnumHandle0--Funktion erstellt ein Handle zum Aufzählen einer Gruppe von IPsec-Kontextobjekten (IPsec Security Association, SA).

Syntax

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

Parameter

[in] engineHandle

Behandeln einer geöffneten Sitzung für das Filtermodul. Rufen Sie FwpmEngineOpen0- auf, um eine Sitzung für das Filtermodul zu öffnen.

[in, optional] enumTemplate

Vorlage, um die Enumeration selektiv einzuschränken.

[out] enumHandle

Adresse einer HANDLE Variable. Bei der Rückgabe der Funktion enthält sie das Handle für die SA-Kontextenumeration.

Rückgabewert

Bemerkungen

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

Der Aufrufer muss IPsecSaContextDestroyEnumHandle0- aufrufen, um den zurückgegebenen Handle freizugeben.

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

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

Anforderungen

Siehe auch

• FwpmEngineOpen0
• IPsecSaContextDestroyEnumHandle0
• FWPM_ACTRL_ENUM
• FWPM_ACTRL_READ
• IPSEC_SA_CONTEXT_ENUM_TEMPLATE0
• Zugriffssteuerung
• WFP-Fehlercodes
• WFP-Version-Independent Namen und zielspezifische Versionen von Windows