IPsecSaContextCreate1-Funktion (fwpmu.h)

Artikel
02/29/2024

Die IPsecSaContextCreate1-Funktion erstellt einen IPsec-Sicherheitszuordnungskontext (SA).

HinweisIPsecSaContextCreate1 ist die spezifische Implementierung von IPsecSaContextCreate, die in Windows 7 und höher verwendet wird. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen . Für Windows Vista ist IPsecSaContextCreate0 verfügbar.

Syntax

DWORD IPsecSaContextCreate1(
  [in]            HANDLE                              engineHandle,
  [in]            const IPSEC_TRAFFIC1                *outboundTraffic,
  [in, optional]  const IPSEC_VIRTUAL_IF_TUNNEL_INFO0 *virtualIfTunnelInfo,
  [out, optional] UINT64                              *inboundFilterId,
  [out]           UINT64                              *id
);

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] outboundTraffic

Typ: IPSEC_TRAFFIC1*

Der ausgehende Datenverkehr der SA.

[in, optional] virtualIfTunnelInfo

Typ: IPSEC_VIRTUAL_IF_TUNNEL_INFO0*

Details zum Tunneln virtueller Schnittstellen.

[out, optional] inboundFilterId

Typ: UINT64*

Optionaler Filterbezeichner des zwischengespeicherten eingehenden Filters, der dem vom Aufrufer angegebenen outboundTraffic-Parameter entspricht. Die Basisfilter-Engine (BFE) kann den Eingehenden Filterbezeichner zwischenspeichern und den zwischengespeicherten Wert zurückgeben, sofern verfügbar. Der Aufrufer muss den Fall behandeln, wenn BFE keinen zwischengespeicherten Wert aufweist. In diesem Fall wird dieser Parameter auf 0 festgelegt.

[out] id

Typ: UINT64*

Der Bezeichner des IPsec SA-Kontexts.

Rückgabewert

Art: DWORD

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der IPsec SA-Kontext wurde erfolgreich erstellt.
*FWP_E_-Fehlercode** 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes .
*RPC_-Fehlercode** 0x80010001 – 0x80010122	Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine.

Hinweise

Diese Funktion kann nicht innerhalb einer Transaktion aufgerufen werden. Bei FWP_E_TXN_IN_PROGRESS tritt ein Fehler auf. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung .

Diese Funktion kann nicht innerhalb einer dynamischen Sitzung aufgerufen werden. Der Aufruf schlägt mit FWP_E_DYNAMIC_SESSION_IN_PROGRESS fehl. Weitere Informationen zu dynamischen Sitzungen finden Sie unter Objektverwaltung .

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fwpmu.h
Bibliothek	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Weitere Informationen

IPSEC_TRAFFIC1

IPSEC_VIRTUAL_IF_TUNNEL_INFO0

Freigeben über