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 .

Syntax

HRESULT GetProperties2(
  [out] VDS_DISK_PROP2 *pDiskProperties
);

Parameter-parameternya

[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 dasar yang sedang digunakan. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Description
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.

Komentar

Dalam struktur VDS_DISK_PROP2 yang dikembalikan dalam parameter pDiskProperties , anggota pwszDiskAddress bersifat opsional dan dapat berupa NULL jika tidak ada nilai yang tersedia. Penelepon metode ini harus memeriksa apakah anggota ini NULL.

Untuk Hyper-V, anggota pwszLocationPath adalah NULL, karena pengontrol virtual tidak mengembalikan jalur lokasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Platform Target	Windows
Header	vds.h
Library	Uuid.lib

Lihat juga

IVdsDisk3

VDS_DISK_PROP2