Metode IStorage::MoveElementTo (objidl.h)
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 |