ITransferSource：：RenameItem 方法 (shobjidl_core.h)

  • 發行項

變更項目的名稱，以新名稱傳回 IShellItem 。

語法

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

參數

[in] psiSource

類型： IShellItem*

要重新命名之 IShellItem 物件的指標。

[in] pszNewName

類型： LPCWSTR

包含新名稱之 Null 終止 Unicode 字串的指標。

[in] flags

類型： TRANSFER_SOURCE_FLAGS

控制檔案作業的旗標。 一或多個 TRANSFER_SOURCE_FLAGS 常數。

[out] ppsiNewDest

類型： IShellItem**

當這個方法傳回時，會包含 IShellItem 物件的指標位址。

傳回值

類型： HRESULT

傳回下列其中一項，或錯誤碼。

傳回碼 Description
COPYENGINE_S_YES
 用戶回應了對話框的 「是」。
COPYENGINE_S_USER_RETRY
 用戶已回應重試目前的動作。
COPYENGINE_S_USER_IGNORED
 用戶回應了對話框的 「否」。
COPYENGINE_S_MERGE
 使用者回應合併資料夾。
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 用戶回應以使用新名稱重試檔案。
COPYENGINE_S_DONT_PROCESS_CHILDREN
 不應該處理子專案。
COPYENGINE_S_PENDING
 錯誤已排入佇列，稍後會顯示。
COPYENGINE_E_USER_CANCELLED
 使用者已取消目前的動作。
COPYENGINE_E_REQUIRES_ELEVATION
 作業需要提高的許可權。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)