FreeCredentialsHandle-Funktion (sspi.h)
Die FreeCredentialsHandle-Funktion benachrichtigt das Sicherheitssystem, dass die Anmeldeinformationen nicht mehr benötigt werden. Eine Anwendung ruft diese Funktion auf, um das Handle der Anmeldeinformationen frei zu geben, das im Aufruf der AcquireCredentialsHandle -Funktion (General) abgerufen wurde, nachdem die DeleteSecurityContext-Funktion aufgerufen wurde, um alle Kontexthandles frei zu geben, die den Anmeldeinformationen zugeordnet sind. Wenn alle Verweise auf diesen Anmeldeinformationssatz entfernt wurden, können die Anmeldeinformationen selbst entfernt werden.
Fehler beim Freigeben von Anmeldeinformationshandles führen zu Speicherverlusten.
Syntax
KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
[in] PCredHandle phCredential
);
Parameter
[in] phCredential
Ein Zeiger auf das CredHandle-Handle , das mithilfe der Funktion AcquireCredentialsHandle (General) abgerufen wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion SEC_E_OK zurück.
Wenn die Funktion fehlschlägt, gibt sie den folgenden Fehlercode zurück.
Rückgabecode | Beschreibung |
---|---|
|
Das an die Funktion übergebene Handle ist ungü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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für