Metode IVdsVolume2::GetProperties2 (vds.h)

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

Mengembalikan informasi properti untuk volume saat ini. Metode ini identik dengan metode IVdsVolume::GetProperties , kecuali bahwa metode ini mengembalikan struktur VDS_VOLUME_PROP2 alih-alih struktur VDS_VOLUME_PROP .

Sintaks

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Parameter

[out] pVolumeProperties

Alamat struktur VDS_VOLUME_PROP2 dialokasikan dan diteruskan oleh pemanggil. VDS mengalokasikan memori untuk string anggota pwszName . 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. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil diselesaikan.
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

Metode ini mengambil pengidentifikasi volume unik untuk volume. Struktur yang berisi pengidentifikasi tersebut VDS_VOLUME_PROP2, bukan VDS_VOLUME_PROP.

Perhatikan bahwa pengidentifikasi volume unik tidak sama dengan jalur GUID volume. Untuk menemukan jalur GUID volume untuk volume, gunakan metode IVdsVolumeMF3::QueryVolumeGuidPathnames .

Persyaratan

Persyaratan	Nilai
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

IVdsVolume2