IPsecSaContextDeleteById0-Funktion (fwpmk.h)

Artikel
07/16/2024

Die IPsecSaContextDeleteById0-Funktion löscht einen IPsec-Sicherheitszuordnungskontext (SA).

Syntax

NTSTATUS IPsecSaContextDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT64 id
);

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

Ein Laufzeitbezeichner für das Objekt, das aus dem System entfernt wird. Dieser Bezeichner wurde vom System empfangen, wenn die Anwendung IPsecSaContextCreate0aufgerufen hat.

Rückgabewert

Zurückgeben von Code/Wert	Beschreibung
ERROR_SUCCESS 0	Der IPsec SA-Kontext wurde erfolgreich gelöscht.
*FWP_E_ Fehlercode** 0x80320001 – 0x80320039	Ein WFP-spezifischer Fehler (Windows-Filterplattform). Weitere Informationen finden Sie unter WFP-Fehlercodes.
*RPC_-Fehlercode** 0x80010001 – 0x80010122	Fehler bei der Kommunikation mit dem Remote- oder lokalen Firewallmodul.
Andere NTSTATUS-Codes	Fehler.

Bemerkungen

Diese Funktion kann nicht innerhalb einer Transaktion aufgerufen werden, sie schlägt mit FWP_E_TXN_IN_PROGRESSfehl. Weitere Informationen zu Transaktionen finden Sie unter Objektverwaltung.

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

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

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows Vista.
Zielplattform-	Universal
Header-	fwpmk.h
Library	fwpkclnt.lib
IRQL-	<= PASSIVE_LEVEL

Siehe auch

Hier sind alle Markdownlinks im aktuellen Dokument:

Freigeben über