IFileOperation：：RenameItems 方法 (shobjidl_core.h)

宣告一組要指定新顯示名稱的專案。所有項目的名稱都相同。

語法

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

[in] pUnkItems

類型： IUnknown*

IShellItemArray、IDataObject 或 IEnumShellItems 物件的 IUnknown 指標，代表要重新命名的專案群組。您也可以指向 IPersistIDList 物件來代表單一專案，有效地完成與 IFileOperation：：RenameItem 相同的函式。

[in] pszNewName

類型： LPCWSTR

專案之新顯示名稱的指標。這是以 Null 結尾的 Unicode 字串。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

如果 pUnkItems 集合中的多個項目位於相同的資料夾中，則重新命名的檔案會加上括弧中的數位來區分它們，例如 newfile (1) .txt、newfile (2) .txt，以及 newfile (3) .txt。

這個方法不會重新命名專案，只會宣告要重新命名的專案。若要重新命名物件群組，您必須至少進行此處詳述的呼叫順序：