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 |
|---|---|
|
Metode berhasil diselesaikan. |
|
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 |