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 參數指定無效 的旗標 。

備註

注意

wincred.h 標頭會將 CredRename 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 wincred.h
程式庫 Advapi32.lib
Dll Advapi32.dll