IVdsSubSystem::Metode GetDrive (vdshwprv.h)

Artikel
03/08/2023

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

Mengembalikan drive yang ditentukan.

Sintaks

HRESULT GetDrive(
  [in]  SHORT     sBusNumber,
  [in]  SHORT     sSlotNumber,
  [out] IVdsDrive **ppDrive
);

Parameter

[in] sBusNumber

Jumlah bus tempat drive tersambung.

[in] sSlotNumber

Jumlah slot yang diduduki drive.

[out] ppDrive

Alamat penunjuk antarmuka IVdsDrive . Penelepon harus merilis antarmuka.

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
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 subsistem tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Subsistem dalam keadaan gagal dan tidak dapat melakukan operasi yang diminta.
VDS_E_ANOTHER_CALL_IN_PROGRESS 0x80042404L	Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai.

Keterangan

Karena sSlotNumber dan sBusNumber mengidentifikasi drive secara eksklusif, pelaksana dapat menetapkan nilai arbitrer (tetapi konsisten) untuk masing-masing sebagai cara internal untuk mengidentifikasi drive. Untuk informasi selengkapnya tentang nomor bus dan slot, lihat anggota sInternalBusNumber dan sSlotNumber dari struktur VDS_DRIVE_PROP .

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	vdshwprv.h
Pustaka	Uuid.lib