IMDSPObject::Move method (mswmdm.h)

Artikel
02/29/2024

Metode Pindahkan memindahkan file atau folder pada perangkat media.

Sintaks

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress,
  [in] IMDSPStorage  *pTarget
);

Parameter

[in] fuMode

Mode pemrosesan untuk memanggil operasi Pindahkan dan metode yang akan dipindahkan. Tentukan salah satu dari dua mode berikut. Jika kedua mode ditentukan, mode blok digunakan.

Mode	Deskripsi
WMDM_MODE_BLOCK	Operasi akan dilakukan menggunakan pemrosesan mode blok. Panggilan tidak akan kembali sampai operasi selesai.
WMDM_MODE_THREAD	Operasi akan dilakukan menggunakan pemrosesan mode utas. Panggilan akan segera kembali, dan operasi akan dilakukan di utas latar belakang.

Tabel berikut mencantumkan bendera yang menunjukkan ke mana objek akan dipindahkan. Satu nilai dari tabel ini dikombinasikan dengan satu nilai dari tabel Mode sebelumnya dengan menggunakan OR bitwise.

Metode pemindahan	Deskripsi
WMDM_STORAGECONTROL_INSERTBEFORE	Objek akan disisipkan sebelum objek target.
WMDM_STORAGECONTROL_INSERTINTO	Objek akan dimasukkan ke dalam objek target. Objek target harus berupa folder. Jika objek target adalah file, metode ini gagal.
WMDM_STORAGECONTROL_INSERTAFTER	Objek akan disisipkan setelah objek target.

[in] pProgress

Arahkan ke antarmuka IWMDMProgress yang telah diimplementasikan oleh aplikasi untuk melacak kemajuan operasi yang sedang berlangsung. Parameter ini bersifat opsional dan harus diatur ke NULL saat tidak digunakan.

[in] pTarget

Arahkan ke objek target sebelum atau sesudahnya Anda ingin meletakkan objek saat ini.

Mengembalikan nilai

Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:

Kode kesalahan COM standar
Kode kesalahan Windows dikonversi ke nilai HRESULT
Kode kesalahan Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

File atau direktori hanya dapat dipindahkan dalam penyimpanan akar yang sama. Objek tempat metode ini dipanggil harus diperbarui untuk mencerminkan lokasi barunya.

Metode ini bersifat opsional. Untuk informasi selengkapnya, lihat Antarmuka Wajib dan Opsional.