DeleteSecurityContext-Funktion (sspi.h)

Die DeleteSecurityContext-Funktion löscht die lokalen Datenstrukturen, die dem angegebenen Sicherheitskontext zugeordnet sind, die durch einen vorherigen Aufruf der Funktion InitializeSecurityContext (General) oder der AcceptSecurityContext -Funktion (Allgemein) initiiert wurden.

Syntax

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

Parameter

[in] phContext

Handle des zu löschenden Sicherheitskontexts.

Warnung

Verwenden Sie nicht dasselbe Kontexthandle bei gleichzeitigen Aufrufen von DeleteSecurityContext. Die API-Implementierung in den Sicherheitsdienstanbietern ist nicht threadsicher.

Rückgabewert

Wenn die Funktion erfolgreich ist oder das Handle bereits gelöscht wurde, wird der Rückgabewert SEC_E_OK.

Wenn die Funktion fehlschlägt, kann der Rückgabewert der folgende Fehlercode sein:

Rückgabecode	Beschreibung
SEC_E_INVALID_HANDLE	Das an die Funktion übergebene Handle ist ungültig.

Hinweise

Die DeleteSecurityContext-Funktion beendet einen Sicherheitskontext und gibt zugeordnete Ressourcen frei.

Der Aufrufer muss diese Funktion für einen Sicherheitskontext aufrufen, wenn dieser Sicherheitskontext nicht mehr benötigt wird. Dies gilt, wenn der Sicherheitskontext teilweise, unvollständig, abgelehnt oder fehlgeschlagen ist. Nachdem der Sicherheitskontext erfolgreich gelöscht wurde, ist die weitere Verwendung dieses Sicherheitskontexts nicht mehr zulässig, und das Handle ist nicht mehr gültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h (einschließlich Security.h)
Bibliothek	Secur32.lib
DLL	Secur32.dll

Weitere Informationen

AcceptSecurityContext (Allgemein)

InitializeSecurityContext (Allgemein)

SSPI-Funktionen