Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IPsecSaContextGetSpi1-Funktion ruft den Sicherheitsparameterindex (SPI) für einen Sicherheitszuordnungskontext (Security Association, SA) ab.
HinweisIPsecSaContextGetSpi1 ist die spezifische Implementierung von IPsecSaContextGetSpi, die in Windows 7 und höher verwendet wird. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen . Für Windows Vista ist IPsecSaContextGetSpi0 verfügbar.
Syntax
DWORD IPsecSaContextGetSpi1(
[in] HANDLE engineHandle,
[in] UINT64 id,
[in] const IPSEC_GETSPI1 *getSpi,
[out] IPSEC_SA_SPI *inboundSpi
);
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] id
Typ: UINT64
Ein Laufzeitbezeichner für den SA-Kontext. Dieser Bezeichner wurde vom System empfangen, als die Anwendung IPsecSaContextCreate1 aufgerufen hat.
[in] getSpi
Typ: IPSEC_GETSPI1*
Der eingehende IPsec-Datenverkehr.
[out] inboundSpi
Typ: IPSEC_SA_SPI*
Der eingehende SA-SPI. Der datentyp IPSEC_SA_SPI wird dem Datentyp UINT32 zugeordnet.
Rückgabewert
Art: DWORD
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der SPI für den IPsec SA-Kontext wurde erfolgreich abgerufen. |
|
Ein WFP-spezifischer Fehler (Windows Filtering Platform). Weitere Informationen finden Sie unter WFP-Fehlercodes . |
|
Fehler bei der Kommunikation mit der Remote- oder lokalen Firewall-Engine. |
Hinweise
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 |