Metode IStorage::MoveElementTo (objidl.h)

  • Artikel

Metode MoveElementTo menyalin atau memindahkan substorase atau aliran dari objek penyimpanan ini ke objek penyimpanan lain.

Sintaks

HRESULT MoveElementTo(
  [in] const OLECHAR *pwcsName,
  [in] IStorage      *pstgDest,
  [in] const OLECHAR *pwcsNewName,
  [in] DWORD         grfFlags
);

Parameter

[in] pwcsName

Penunjuk ke string Unicode karakter lebar yang dihentikan null yang berisi nama elemen dalam objek penyimpanan ini untuk dipindahkan atau disalin.

[in] pstgDest

Penunjuk IStorage ke objek penyimpanan tujuan.

[in] pwcsNewName

Penunjuk ke string unicode karakter lebar yang dihentikan null yang berisi nama baru untuk elemen dalam objek penyimpanan barunya.

[in] grfFlags

Menentukan apakah operasi harus berupa pemindahan (STGMOVE_MOVE) atau salinan (STGMOVE_COPY). Lihat enumerasi STGMOVE .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK Objek penyimpanan berhasil disalin atau dipindahkan.
E_PENDING Hanya Penyimpanan Asinkron: Bagian atau semua data elemen saat ini tidak tersedia.
STG_E_ACCESSDENIED Objek penyimpanan tujuan adalah anak dari objek penyimpanan sumber. Atau, objek tujuan dan nama elemen sama dengan objek sumber dan nama elemen. Dengan kata lain, Anda tidak dapat memindahkan elemen ke dirinya sendiri.
STG_E_FILENOTFOUND Elemen dengan nama yang ditentukan tidak ada.
STG_E_FILEALREADYEXISTS File yang ditentukan sudah ada.
STG_E_INSUFFICIENTMEMORY Salinan atau pemindahan tidak selesai karena kurangnya memori.
STG_E_INVALIDFLAG Nilai untuk parameter grfFlags tidak valid.
STG_E_INVALIDNAME Bukan nilai yang valid untuk pwcsName.
STG_E_INVALIDPOINTER Penunjuk yang ditentukan untuk objek penyimpanan tidak valid.
STG_E_INVALIDPARAMETER Salah satu parameter tidak valid.
STG_E_REVERTED Objek penyimpanan telah dibatalkan oleh operasi kembali di atasnya di pohon transaksi.
STG_E_TOOMANYOPENFILES Salinan atau pemindahan tidak selesai karena terlalu banyak file yang terbuka.

Keterangan

Metode IStorage::MoveElementTo biasanya sama dengan memanggil metode IStorage::CopyTo pada elemen yang ditunjukkan lalu menghapus elemen sumber. Dalam hal ini, metode MoveElementTo hanya menggunakan fungsi yang tersedia untuk umum dari objek penyimpanan tujuan untuk melakukan pemindahan.

Jika objek penyimpanan sumber dan tujuan memiliki pengetahuan khusus tentang implementasi satu sama lain (mereka dapat, misalnya, menjadi instans yang berbeda dari implementasi yang sama), metode ini dapat diimplementasikan dengan lebih efisien.

Sebelum memanggil metode ini, elemen yang akan dipindahkan harus ditutup, dan penyimpanan tujuan harus terbuka. Selain itu, objek dan elemen tujuan tidak boleh menjadi nama objek/elemen penyimpanan yang sama dengan sumber pemindahan. Artinya, Anda tidak dapat memindahkan elemen ke dirinya sendiri.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header objidl.h
Pustaka Uuid.lib
DLL Ole32.dll

Lihat juga

IStorage - Implementasi File Gabungan

IStorage::CopyTo

STGMOVE