IWMDMStorageControl::Move method (mswmdm.h)

Artikel
03/05/2024

Metode Pindahkan memindahkan penyimpanan saat ini ke lokasi baru pada perangkat.

Sintaks

HRESULT Move(
  [in] UINT          fuMode,
  [in] IWMDMStorage  *pTargetObject,
  [in] IWMDMProgress *pProgress
);

Parameter

[in] fuMode

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

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

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

Bendera	Deskripsi
WMDM_STORAGECONTROL_INSERTBEFORE	Objek disisipkan sebelum objek target.
WMDM_STORAGECONTROL_INSERTINTO	Objek disisipkan ke dalam objek target.
WMDM_STORAGECONTROL_INSERTAFTER	Objek disisipkan setelah objek target.

[in] pTargetObject

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

[in] pProgress

Penunjuk opsional ke antarmuka IWMDMProgress yang telah diimplementasikan oleh aplikasi untuk melacak kemajuan operasi yang sedang berlangsung.

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.

Jika bendera WMDM_MODE_THREAD ditentukan, Anda harus mendapatkan status penyelesaian dengan memanggil IWMDMProgress2::End2 atau IWMDMProgress3::End3. Metode ini akan memastikan bahwa operasi selesai dan juga akan mengembalikan HRESULT dengan informasi keberhasilan atau kegagalan.

Jika aplikasi menggunakan WMDM_MODE_THREAD dan melewati parameter pProgress non-null, aplikasi harus memastikan bahwa objek tempat pProgress berada tidak dihancurkan sampai operasi pemindahan selesai, karena Pengelola Perangkat Media Windows akan mengirim pemberitahuan kemajuan ke objek ini. Objek ini dapat dihancurkan hanya setelah menerima pemberitahuan Akhir. Kegagalan untuk melakukan ini akan mengakibatkan pelanggaran akses.