Metode IVdsService::QueryUnallocatedDisks (vds.h)

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

Mengembalikan objek enumerasi yang berisi daftar disk yang tidak dialokasikan yang dikelola oleh VDS.

Sintaks

HRESULT QueryUnallocatedDisks(
  [out] IEnumVdsObject **ppEnum
);

Parameter

[out] ppEnum

Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung disk sebagai objek disk. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus melepaskan antarmuka dan masing-masing objek disk ketika tidak lagi diperlukan dengan memanggil metode IUnknown::Release .

Mengembalikan nilai

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	Enumerasi berhasil dikembalikan.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir hingga inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Disk yang tidak dialokasikan tidak diklaim oleh penyedia mana pun. Ini mungkin atau mungkin tidak berisi informasi format partisi MBR atau GPT. Seringkali itu adalah disk yang tidak diinisialisasi. Jika status disk VDS_DS_ONLINE atau VDS_DS_OFFLINE, disk tidak dialokasikan dan tidak diinisialisasi. Jika VDS_DS_UNKNOWN, VDS_DS_NOT_READY, VDS_DS_FAILED, atau VDS_DS_MISSING, layanan tersebut tidak dialokasikan, tetapi layanan VDS tidak dapat menentukan apakah itu diinisialisasi atau tidak, mungkin karena masalah dengan disk.

Untuk menentukan status disk, lihat anggota status struktur VDS_DISK_PROP atau VDS_DISK_PROP2 untuk disk.

Jika status disk VDS_DS_ONLINE, disk dapat ditambahkan ke paket.

Jika status disk VDS_DS_OFFLINE, coba jadikan disk online dengan memanggil IVdsDiskOnline::Online. Jika panggilan ke metode Online berhasil, disk dapat ditambahkan ke paket. Jika panggilan ke Online gagal, disk tidak dapat digunakan.

Persyaratan

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

Lihat juga

IEnumVdsObject

IVdsService