CredRenameA 函数（wincred.h）

[ 不再支持CredRename。从 Windows Vista 开始，对 CredRename 的调用始终返回ERROR_NOT_SUPPORTED。]

CredRename 函数重命名用户的凭据集中的凭据。使用的凭据集是与当前令牌的登录会话关联的凭据集。令牌不得禁用用户的 SID。

语法

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 函数以获取更具体的状态代码。可以返回以下状态代码：

注意

wincred.h 标头将 CredRename 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。