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 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。