Функция 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 .

Комментарии

Требования