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 函式 ，以取得更具體的狀態代碼。 可以傳回下列狀態代碼：

• ERROR_NOT_FOUND

  沒有具有指定之 OldTargetName的認證。

• ERROR_ALREADY_EXISTS

  已經有認證或類型 Type，並命名 NewTargetName。

• ERROR_NO_SUCH_LOGON_SESSION

  登入會話不存在，或沒有與此登入會話相關聯的認證集。 網路登入會話沒有相關聯的認證集。

• ERROR_INVALID_FLAGS

  Flags 參數指定了無效的旗標。

言論

要求