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)