Metode IFileOperation::RenameItems (shobjidl_core.h)

Artikel
03/04/2024

Menyatakan sekumpulan item yang akan diberi nama tampilan baru. Semua item diberi nama yang sama.

Sintaks

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

Parameter

[in] pUnkItems

Jenis: IUnknown*

Arahkan ke IUnknown objek IShellItemArray, IDataObject, atau IEnumShellItems yang mewakili grup item yang akan diganti namanya. Anda juga dapat menunjuk ke objek IPersistIDList untuk mewakili satu item, secara efektif menyelesaikan fungsi yang sama dengan IFileOperation::RenameItem.

[in] pszNewName

Jenis: LPCWSTR

Arahkan ke nama tampilan baru item. Ini adalah string Unicode yang dihentikan null.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Jika lebih dari satu item dalam koleksi di pUnkItems berada di folder yang sama, file yang diganti namanya ditambahkan dengan angka dalam tanda kurung untuk membedakannya, misalnya newfile(1).txt, newfile(2).txt, dan newfile(3).txt.

Metode ini tidak mengganti nama item, metode ini hanya menyatakan item yang akan diganti namanya. Untuk mengganti nama sekelompok objek, Anda harus membuat setidaknya urutan panggilan yang dirinci di sini:

Panggil IFileOperation::RenameItems untuk mendeklarasikan file atau folder sumber dan nama baru.
Panggil IFileOperation::P erformOperations untuk memulai operasi ganti nama.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Lihat juga

IFileOperation

IFileOperation::RenameItem

Bagikan melalui