Metode IVdsLun::D elete (vdshwprv.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Menghapus LUN dan semua pleksnya. Data apa pun di LUN hilang. VDS membebaskan jangkauan yang dialokasikan untuk LUN.

Sintaks

HRESULT Delete();

Mengembalikan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Nilai pengembalian ini menandakan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang array. Gunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache.
VDS_E_OBJECT_DELETED 0x8004240BL	Objek LUN tidak lagi ada.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	LUN dalam status gagal dan tidak dapat melakukan operasi yang diminta.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai.

Keterangan

Jika aplikasi memegang referensi ke antarmuka IVdsLun dan memanggil IVdsLun::D elete, pelaksana harus mengembalikan VDS_E_OBJECT_DELETED pada panggilan berikutnya ke metode seperti GetProperties pada antarmuka tersebut. Dalam hal ini, antarmuka memiliki referensi yang luar biasa dan valid, tetapi objek yang mendasar tidak ada lagi.

Jika LUN yang dicabut ke komputer target dihapus, visibilitas LUN pada komputer tersebut mungkin tidak berubah sampai proses memula ulang bus dilakukan. Aplikasi VDS pada komputer target memulai pemulaian ulang bus dengan memanggil IVdsService::Reenumerate. Memulai pemulaian ulang bus adalah tanggung jawab aplikasi VDS, bukan penyedia perangkat keras.

Jika metode seperti IVdsLun::D elete dipanggil dalam satu utas sementara IVdsSubSystem::QueryLuns dipanggil di utas lain yang berjalan secara bersamaan, hasilnya bisa menjadi pelanggaran akses penyedia. Penyedia perangkat keras bertanggung jawab untuk menserialisasikan metode ini sesuai kebutuhan untuk meminimalkan masalah sinkronisasi tersebut.

Penyedia perangkat keras bertanggung jawab untuk menghapus informasi partisi LUN sehingga LUN dapat digunakan kembali. Jika LUN adalah disk MBR, ini dicapai dengan menulis nol ke 1 MB pertama dan terakhir disk. Untuk disk GPT, nol harus ditulis ke disk 16 KB pertama dan terakhir.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vdshwprv.h
Pustaka	Uuid.lib

Lihat juga

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsLun

IVdsLun::GetProperties