CredDeleteA-Funktion (wincred.h)
Die CredDelete-Funktion löscht Anmeldeinformationen aus dem Anmeldeinformationssatz des Benutzers. Bei dem verwendeten Anmeldeinformationssatz handelt es sich um den Satz, der der Anmeldesitzung des aktuellen Tokens zugeordnet ist. Für das Token darf die SID des Benutzers nicht deaktiviert sein.
Syntax
BOOL CredDeleteA(
[in] LPCSTR TargetName,
[in] DWORD Type,
[in] DWORD Flags
);
Parameter
[in] TargetName
Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der zu löschenden Anmeldeinformationen enthält.
[in] Type
Typ der zu löschenden Anmeldeinformationen. Muss einer der CRED_TYPE_* definierten Typen sein. Eine Liste der definierten Typen finden Sie im Element Typ der CREDENTIAL-Struktur .
Wenn der Wert dieses Parameters CRED_TYPE_DOMAIN_EXTENDED ist, kann diese Funktion Anmeldeinformationen löschen, die einen Benutzernamen angeben, wenn mehrere Anmeldeinformationen für dasselbe Ziel vorhanden sind. Der Wert des TargetName-Parameters muss den Benutzernamen alsZielbenutzername| angeben.
[in] Flags
Reserviert und muss null sein.
Rückgabewert
Die Funktion gibt TRUE bei Erfolg und FALSE bei Einem Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Die folgenden status Codes können zurückgegeben werden:
- ERROR_NOT_FOUND
Es sind keine Anmeldeinformationen mit dem angegebenen TargetName vorhanden.
- ERROR_NO_SUCH_LOGON_SESSION
Die Anmeldesitzung ist nicht vorhanden, oder dieser Anmeldesitzung ist kein Anmeldeinformationssatz zugeordnet. Netzwerkanmeldungssitzungen verfügen nicht über einen zugeordneten Anmeldeinformationssatz.
- ERROR_INVALID_FLAGS
Für den Flags-Parameter wurde ein ungültiges Flag angegeben.
Hinweise
Hinweis
Der wincred.h-Header definiert CredDelete als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
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 | wincred.h |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |