Metode IFileOperation::MoveItem (shobjidl_core.h)

Menyatakan satu item yang akan dipindahkan ke tujuan tertentu.

Sintaks

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parameter

[in] psiItem

Jenis: IShellItem*

Penunjuk ke IShellItem yang menentukan item sumber.

[in] psiDestinationFolder

Jenis: IShellItem*

Penunjuk ke IShellItem yang menentukan folder tujuan untuk memuat item yang dipindahkan.

[in] pszNewName

Jenis: LPCWSTR

Arahkan ke nama baru untuk item di lokasi barunya. Ini adalah string Unicode yang dihentikan null dan dapat berupa NULL. Jika NULL, nama item tujuan sama dengan sumbernya.

[in] pfopsItem

Jenis: IFileOperationProgressSink*

Penunjuk ke objek IFileOperationProgressSink yang akan digunakan untuk status kemajuan dan pemberitahuan kesalahan untuk operasi pemindahan khusus ini. Jika Anda memanggil IFileOperation::Advise untuk operasi keseluruhan, status kemajuan dan pemberitahuan kesalahan untuk operasi pemindahan disertakan di sana, jadi atur parameter ini ke NULL.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini tidak memindahkan item, itu hanya menyatakan item yang akan dipindahkan. Untuk memindahkan objek, Anda harus membuat setidaknya urutan panggilan yang dirinci di sini:

1. Panggil IFileOperation::MoveItem untuk mendeklarasikan item sumber, folder tujuan, dan nama tujuan.
2. Panggil IFileOperation::P erformOperations untuk memulai operasi pemindahan.

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::MoveItems

PostMoveItem

PreMoveItem