Bagikan melalui


Metode IVdsDrive::GetProperties (vds.h)

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

Mengembalikan properti objek drive.

Sintaks

HRESULT GetProperties(
  [out] VDS_DRIVE_PROP *pDriveProp
);

Parameter

[out] pDriveProp

Alamat struktur VDS_DRIVE_PROP dialokasikan dan diteruskan oleh pemanggil. VDS mengalokasikan memori untuk string anggota pwszFriendlyName dan pwszIdentification . 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
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.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
Nilai pengembalian ini menandakan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang array. Gunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache.
VDS_E_OBJECT_DELETED
0x8004240BL
Objek drive tidak ada lagi.

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

IVdsDrive

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

VDS_DRIVE_PROP