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 |