Freigeben über

CredDeleteA-Funktion (wincred.h)

  • Artikel

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