CredRenameA-Funktion (wincred.h)
[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 |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für