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

[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 [только классические приложения]
Целевая платформа	Windows
Header	wincred.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll