Metode IVdsDisk3::GetProperties2 (vds.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]
Mengembalikan informasi properti untuk disk. Metode ini identik dengan metode IVdsDisk::GetProperties , kecuali bahwa metode ini mengembalikan struktur VDS_DISK_PROP2 alih-alih struktur VDS_DISK_PROP .
Sintaks
HRESULT GetProperties2(
[out] VDS_DISK_PROP2 *pDiskProperties
);
Parameter
[out] pDiskProperties
Alamat struktur VDS_DISK_PROP2 dialokasikan dan diteruskan oleh pemanggil. VDS mengalokasikan memori untuk string anggota pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath, dan pwszLocationPath . Penelepon harus membebaskan string dengan menggunakan fungsi CoTaskMemFree .
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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Properti berhasil dikembalikan. |
|
Beberapa tetapi tidak semua properti berhasil diambil. Perhatikan bahwa ada banyak kemungkinan alasan untuk gagal mengambil semua properti, termasuk penghapusan perangkat. |
Keterangan
Dalam struktur VDS_DISK_PROP2 yang dikembalikan dalam parameter pDiskProperties , anggota pwszDiskAddress bersifat opsional dan dapat berupa NULL jika tidak ada nilai yang tersedia. Pemanggil metode ini harus memeriksa apakah anggota ini ADALAH NULL.
Untuk Hyper-V, anggota pwszLocationPath adalah NULL, karena pengontrol virtual tidak mengembalikan jalur lokasi.
Persyaratan
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | vds.h |
Pustaka | Uuid.lib |