共用方式為


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)