CredRenameA-Funktion (wincred.h)

Artikel
03/03/2024

[CredRename wird nicht mehr unterstützt. Ab Windows Vista geben Aufrufe von CredRename immer ERROR_NOT_SUPPORTED zurück.]

Die CredRename-Funktion benennt Anmeldeinformationen im Anmeldeinformationssatz des Benutzers um. Der verwendete Anmeldeinformationssatz ist der der Anmeldesitzung des aktuellen Tokens zugeordnet. Für das Token darf die SID des Benutzers nicht deaktiviert sein.

Syntax

BOOL CredRenameA(
  [in] LPCSTR OldTargetName,
  [in] LPCSTR NewTargetName,
  [in] DWORD  Type,
  [in] DWORD  Flags
);

Parameter

[in] OldTargetName

Zeiger auf eine NULL-Zeichenfolge, die den aktuellen Namen der umzubenennten Anmeldeinformationen enthält.

[in] NewTargetName

Zeiger auf eine NULL-Zeichenfolge, die den neuen Namen für die Anmeldeinformationen enthält.

[in] Type

Typ der umzubenennten Anmeldeinformationen. Muss einer der definierten CRED_TYPE_* sein.

[in] Flags

Flags, um den Betrieb der Funktion zu steuern. Derzeit reserviert und muss null sein.

Rückgabewert

Die Funktion gibt TRUE bei erfolg und FALSE bei 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 OldTargetName vorhanden.
ERROR_ALREADY_EXISTS
Es gibt bereits einen Anmeldeinformations- oder Typtyp und den Namen NewTargetName.
ERROR_NO_SUCH_LOGON_SESSION
Die Anmeldesitzung ist nicht vorhanden, oder dieser Anmeldesitzung sind keine Anmeldeinformationen 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 CredRename als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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

Freigeben über