Функция CredRenameA (wincred.h)

Статья
11/20/2024

[CredRename больше не поддерживается. Начиная с Windows Vista вызовы CredRename всегда возвращают ERROR_NOT_SUPPORTED.]

Функция CredRename переименовывает учетные данные в наборе учетных данных пользователя. Используемый набор учетных данных связан с сеансом входа в текущий токен. Маркер не должен отключить идентификатор безопасности пользователя.

Синтаксис

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

Параметры

[in] OldTargetName

Указатель на строку, завершающуюся значением NULL, которая содержит текущее имя учетных данных для переименования.

[in] NewTargetName

Указатель на строку, завершающую значение NULL, содержащую новое имя для учетных данных.

[in] Type

Тип учетных данных для переименования. Должен быть одним из определений CRED_TYPE_*.

[in] Flags

Флаги для управления операцией функции. В настоящее время зарезервировано и должно быть равно нулю.

Возвращаемое значение

Функция возвращает TRUE при успешном выполнении и false при сбое. Функцию getLastError можно вызвать , чтобы получить более конкретный код состояния. Можно вернуть следующие коды состояния:

ERROR_NOT_FOUND
Учетные данные с указанным OldTargetNameотсутствуют.
ERROR_ALREADY_EXISTS
Уже есть учетные данные или тип type и именованный NewTargetName.
ERROR_NO_SUCH_LOGON_SESSION
Сеанс входа не существует или нет набора учетных данных, связанных с этим сеансом входа. Сеансы входа в сеть не имеют связанного набора учетных данных.
ERROR_INVALID_FLAGS
Недопустимый флаг был указан для параметра Flags.

Замечания

Заметка

Заголовок wincred.h определяет CredRename как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	wincred.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll

Поделиться через