Metode IVdsServiceUninstallDisk::UninstallDisks (vds.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 instalan sekumpulan disk.

Sintaks

HRESULT UninstallDisks(
  [in]  VDS_OBJECT_ID *pDiskIdArray,
  [in]  ULONG         ulCount,
  [in]  BOOLEAN       bForce,
  [out] BOOLEAN       *pbReboot,
  [out] HRESULT       *pResults
);

Parameter

[in] pDiskIdArray

Alamat buffer yang berisi array ID objek VDS, satu untuk setiap disk yang akan dihapus instalasinya. Setiap ID dalam array harus unik.

[in] ulCount

Jumlah ID objek VDS dalam buffer yang dirujuk parameter pDiskIdArray .

[in] bForce

Jika TRUE, VDS menghapus instalan disk meskipun volume tidak dapat dikunci atau dilepas.

[out] pbReboot

Alamat variabel BOOLEAN yang menerima TRUE jika pengguna harus menghidupkan ulang komputer untuk menyelesaikan proses penghapusan instalasi.

[out] pResults

Alamat array nilai HRESULT yang dialokasikan pemanggil. Jumlah elemen dalam array diarahkan oleh parameter pDiskIdArray . Elemen pertama dari array ini sesuai dengan elemen pertama dalam pDiskIdArray, dan sebagainya. Jika salah satu disk gagal menginisialisasi dengan benar, kode kesalahan tertentu untuk kegagalan dikembalikan dalam elemen yang sesuai dari array ini.

Nilai kembali

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau 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
S_OK 0	Disk berhasil dihapus instalasinya.
S_FALSE 1	Metode ini mengembalikan kode peringatan atau kesalahan untuk satu atau beberapa disk.
VDS_S_UNABLE_TO_GET_GPT_ATTRIBUTES 0x0004245BL	Disk berhasil dihapus instalasinya, tetapi atribut tabel partisi GUID (GPT) tidak dapat diambil untuk satu atau beberapa disk.
VDS_E_INTERNAL_ERROR 0x80042448L	VDS mengalami kesalahan internal. Periksa log peristiwa untuk informasi selengkapnya.
VDS_E_MISSING_DISK 0x80042454L	Satu atau beberapa diska hilang.
VDS_E_NO_DISK_PATHNAME 0x8004270FL	Jalur tidak dapat diambil untuk satu atau beberapa disk.
VDS_E_NO_VOLUME_PATHNAME 0x80042711L	Jalur tidak dapat diambil untuk satu atau beberapa volume.
VDS_E_OBJECT_DELETED 0x8004240BL	Satu atau beberapa ID objek VDS yang ditentukan sesuai dengan disk yang tidak lagi ada.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Satu atau beberapa ID objek VDS yang ditentukan sesuai dengan disk yang tidak ada.
VDS_E_PROVIDER_CACHE_OUTOFSYNC 0x80042712L	Cache penyedia tidak sinkron dengan cache driver.

Keterangan

VDS mengimplementasikan metode ini.

Metode ini, yang sinkron, pertama-tama menghapus instalan volume pada disk yang ditentukan, lalu menghapus instalan disk. Setelah disk dihapus, LUN yang sesuai dapat disembunyikan (tersembunyi) atau dihapus.

Metode ini membersihkan huruf kandar yang ditetapkan ke volume pada disk. Selain itu, ini mengatur volume offline untuk mencegah volume dipasang kembali setelah handel dilepas ditutup tetapi sebelum disk benar-benar dihapus.

Saat menghapus volume dinamis yang mencakup lebih dari satu disk, Anda harus memanggil metode ini alih-alih menggunakan fungsi manajer perangkat.

Untuk instruksi tentang cara menghapus instalan disk pada rilis Windows Server 2003 di mana metode UninstallDisks tidak didukung, lihat bagian Keterangan dari metode IVdsLun::SetMask .

Persyaratan

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

Lihat juga

IVdsServiceUninstallDisk

Bagikan melalui