Bagikan melalui

Metode ITransferSource::RenameItem (shobjidl_core.h)

  • Artikel

Mengubah nama item, mengembalikan IShellItem dengan nama baru.

Sintaks

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

Parameter

[in] psiSource

Jenis: IShellItem*

Penunjuk ke objek IShellItem yang akan diganti namanya.

[in] pszNewName

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi nama baru.

[in] flags

Jenis: TRANSFER_SOURCE_FLAGS

Bendera yang mengontrol operasi file. Satu atau beberapa konstanta TRANSFER_SOURCE_FLAGS .

[out] ppsiNewDest

Jenis: IShellItem**

Ketika metode ini kembali, berisi alamat penunjuk ke objek IShellItem .

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan salah satu dari berikut ini, atau kode kesalahan.

Menampilkan kode Deskripsi
COPYENGINE_S_YES
 Pengguna merespons "Ya" ke dialog.
COPYENGINE_S_USER_RETRY
 Pengguna merespons untuk mencoba kembali tindakan saat ini.
COPYENGINE_S_USER_IGNORED
 Pengguna merespons "Tidak" ke dialog.
COPYENGINE_S_MERGE
 Pengguna merespons untuk menggabungkan folder.
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 Pengguna merespons untuk mencoba kembali file dengan nama baru.
COPYENGINE_S_DONT_PROCESS_CHILDREN
 Item anak tidak boleh diproses.
COPYENGINE_S_PENDING
 Kesalahan telah diantrekan dan akan ditampilkan nanti.
COPYENGINE_E_USER_CANCELLED
 Pengguna membatalkan tindakan saat ini.
COPYENGINE_E_REQUIRES_ELEVATION
 Operasi membutuhkan hak istimewa yang ditingkatkan.

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)