Metode ITransferSource::MoveItem (shobjidl_core.h)

Artikel
03/13/2024

Memindahkan item dalam volume/namespace, mengembalikan IShellItem di lokasi barunya.

Sintaks

HRESULT MoveItem(
  [in]  IShellItem            *psi,
  [in]  IShellItem            *psiParentDst,
  [in]  LPCWSTR               pszNameDst,
        TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNew
);

Parameter

[in] psi

Jenis: IShellItem*

Penunjuk ke IShellItem untuk dipindahkan.

[in] psiParentDst

Jenis: IShellItem*

Penunjuk ke IShellItem yang mewakili item induk baru di tujuan.

[in] pszNameDst

Jenis: LPCWSTR

Penunjuk ke buffer yang dihentikan null yang berisi jalur tujuan.

flags

Jenis: TRANSFER_SOURCE_FLAGS

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

[out] ppsiNew

Jenis: IShellItem**

Ketika metode ini berhasil dikembalikan, berisi alamat penunjuk ke IShellItem di lokasi barunya.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika pemindahan berhasil. Dalam hal ini, ppsiNew menunjuk ke alamat item baru. Kemungkinan nilai pengembalian lainnya, baik kode keberhasilan maupun kegagalan, meliputi yang berikut ini:

Menampilkan kode	Deskripsi
COPYENGINE_S_USER_IGNORED	Item tujuan sudah ada dan belum ditimpa. Dalam hal ini, ppsiNew adalah NULL dan pemanggil harus menghapus item sumber.
COPYENGINE_S_MERGE	Item tujuan sudah ada dan pengguna telah memilih untuk menggabungkan folder sumber dan tujuan. Dalam hal ini, ppsiNew menunjuk ke nilai NULL dan pemanggil harus menghapus item sumber.
E_NOINTERFACE	Ketika item yang dipindahkan adalah folder, pemanggil harus mengonversi operasi pemindahan menjadi operasi salin dan hapus.
ERROR_NOT_SAME_DEVICE	Pemanggil harus mengonversi operasi pemindahan menjadi operasi salin dan hapus. Kesalahan ini dilihat sebagai `HRESULT_FROM_WIN32(ERROR_NOT_SAME_DEVICE)`.
ERROR_FILE_EXISTS	Saat memindahkan folder, penelepon harus mengonversi operasi pemindahan menjadi operasi salin dan hapus. Item tujuan harus mendukung ITransferDestination. Kesalahan ini dilihat sebagai `HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)`.
ERROR_ALREADY_EXISTS	Saat memindahkan folder, penelepon harus mengonversi operasi pemindahan menjadi operasi salin dan hapus. Item tujuan harus mendukung ITransferDestination. Kesalahan ini dilihat sebagai `HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)`.

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)

Bagikan melalui