Metode IVdsDisk3::GetProperties2 (vds.h)

Artikel
03/08/2023

[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
S_OK	Properti berhasil dikembalikan.
VDS_S_PROPERTIES_INCOMPLETE 0x00042715L	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

Lihat juga

IVdsDisk3

VDS_DISK_PROP2