FreeCredentialsHandle-Funktion (sspi.h)

  • Artikel

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
SEC_E_INVALID_HANDLE
 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

AcquireCredentialsHandle (Allgemein)

SSPI-Funktionen