SspiDeleteSecurityContextAsync-Funktion (sspi.h)
Die SspiDeleteSecurityContextAsync-Funktion löscht die lokalen Datenstrukturen, die dem angegebenen Sicherheitskontext zugeordnet sind, die durch einen vorherigen Aufruf der SspiInitializeSecurityContextAsync-Funktion oder der SspiAcceptSecurityContextAsync-Funktion initiiert wurden.
Syntax
SECURITY_STATUS SspiDeleteSecurityContextAsync(
SspiAsyncContext *AsyncContext,
PCtxtHandle phContext
);
Parameter
AsyncContext
Der asynchrone Aufrufkontext.
phContext
Handle des zu löschenden Sicherheitskontexts.
Rückgabewert
Gibt SEC_E_OK zurück, wenn die asynchrone Anforderung zum Löschen des Sicherheitskontexts erfolgreich für die Ausführung in die Warteschlange gestellt wurde. Andernfalls wird der Fehler zurückgegeben, der beim Versuch der Warteschlange generiert wurde. Verwenden Sie SspiGetAsyncCallStatus, um die status des Vorgangs abzurufen.
SspiGetAsyncCallStatus gibt nach Abschluss SEC_E_OK zurück. Andernfalls kann es SEC_I_ASYNC_CALL_PENDING zurückgeben, wenn der Aufruf noch ausgeführt wird, oder einen der folgenden Fehlercodes.
Rückgabecode |
Beschreibung |
|---|---|
| SEC_E_INVALID_HANDLE | Das an die Funktion übergebene Handle ist ungültig. |
Hinweise
Bei asynchroner Anrufvervollständigung können Anrufer den Empfang einer Benachrichtigung deaktivieren, indem sie vermeiden, einen Rückruf für einen neuen SspiAsyncContext festzulegen oder den Rückruf mithilfe von SspiSetAsyncNotifyCallback mit einem NULL-Parameter zu entfernen. Wenn er sich abmeldet, sollte der Aufrufer den Kontext mit SspiFreeAsyncContext unmittelbar nach dem Aufruf von SspiDeleteSecurityContextAsync freigeben, es sei denn, der Kontext ist für die Wiederverwendung vorgesehen.
Die SspiDeleteSecurityContextAsync-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 zulässig, und das Handle ist nicht mehr gültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [nur Kernelmodustreiber] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Kernelmodustreiber] |
| Kopfzeile | sspi.h |
Weitere Informationen
SspiAcceptSecurityContextAsync