Metode IStorage::D estroyElement (objidl.h)
Metode DestroyElement menghapus penyimpanan atau aliran yang ditentukan dari objek penyimpanan ini.
Sintaks
HRESULT DestroyElement(
[in] const OLECHAR *pwcsName
);
Parameter
[in] pwcsName
Penunjuk ke string Unicode karakter lebar yang dihentikan null yang berisi nama penyimpanan atau aliran yang akan dihapus.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
| Menampilkan kode | Deskripsi |
|---|---|
| S_OK | Elemen berhasil dihapus. |
| E_PENDING | Hanya Penyimpanan Asinkron: Bagian atau semua data elemen saat ini tidak tersedia. |
| STG_E_ACCESSDENIED | Pemanggil tidak memiliki izin untuk menghapus elemen. |
| STG_E_FILENOTFOUND | Elemen dengan nama yang ditentukan tidak ada. |
| STG_E_INSUFFICIENTMEMORY | Elemen tidak dihapus karena kurangnya memori. |
| STG_E_INVALIDNAME | Nilai tidak valid untuk pwcsName. |
| STG_E_INVALIDPOINTER | Penunjuk yang ditentukan untuk elemen 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 | Elemen tidak dihapus karena terlalu banyak file yang terbuka. |
Keterangan
Metode DestroyElement menghapus substorage atau streaming dari objek penyimpanan saat ini. Setelah panggilan berhasil ke DestroyElement, setiap instans terbuka elemen yang dihancurkan dari penyimpanan induk menjadi tidak valid.
Jika objek penyimpanan dibuka dalam mode yang ditransaksikan, penghancuran elemen mengharuskan panggilan ke DestroyElement diikuti dengan panggilan ke IStorage::Commit.
Untuk aliran konten, sektor aliran yang dihapus ditandai sebagai gratis. Jika sektor gratis berada di akhir file, file dokumen harus menyusut. Untuk memampatkan file dokumen, panggil IStorage::CopyTo pada objek penyimpanan akar dan salin ke objek penyimpanan baru.
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 |