IFileOperation：：RenameItem 方法 (shobjidl_core.h)
宣告要指定新顯示名稱的單一專案。
語法
HRESULT RenameItem(
[in] IShellItem *psiItem,
[in] LPCWSTR pszNewName,
[in] IFileOperationProgressSink *pfopsItem
);
參數
[in] psiItem
類型： IShellItem*
指定來源專案的 IShellItem 指標。
[in] pszNewName
類型： LPCWSTR
專案之新 顯示名稱 的指標。 這是以 Null 結尾的 Unicode 字串。
[in] pfopsItem
類型： IFileOperationProgressSink*
要用於狀態和失敗通知的 IFileOperationProgressSink 物件的指標。 如果您針對整體作業呼叫 IFileOperation：：建議 ，則會在該處包含重新命名作業的進度狀態和錯誤通知，因此請將此參數設定為 Null。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
這個方法不會重新命名專案，它只會宣告要重新命名的專案。 若要重新命名物件，您必須至少進行此處詳述的呼叫順序：
- 呼叫 IFileOperation：：RenameItem 以宣告新名稱。
- 呼叫 IFileOperation：:P erformOperations 以開始重新命名作業。
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | shobjidl_core.h (包括 Shobjidl.h) |