Metode IVdsDisk::GetProperties (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Mengembalikan informasi properti untuk disk.

Sintaks

HRESULT GetProperties(
  [out] VDS_DISK_PROP *pDiskProperties
);

Parameter

[out] pDiskProperties

Alamat struktur VDS_DISK_PROP dialokasikan dan diteruskan oleh pemanggil. VDS mengalokasikan memori untuk string anggota pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, dan pwszDevicePath . 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.

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

IVdsDisk

VDS_DISK_PROP