Metode IVdsControllerControllerPort::QueryControllerPorts (vdshwprv.h)

  • Artikel

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

Mengembalikan objek IEnumVdsObject yang menghitung port pengontrol.

Sintaks

HRESULT QueryControllerPorts(
  [out] IEnumVdsObject **ppEnum
);

Parameter

[out] ppEnum

Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung port pengontrol sebagai objek port pengontrol. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus melepaskan antarmuka dan masing-masing objek port pengontrol ketika mereka tidak lagi diperlukan dengan memanggil metode IUnknown::Release .

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
S_OK
 Enumerasi port pengontrol berhasil dikembalikan. Jika pengontrol tidak memiliki port, enumerasi kosong.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Cache penyedia rusak. Ini menunjukkan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang perangkat yang terpasang. Pemanggil dapat menggunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache.
VDS_E_OBJECT_DELETED
0x8004240BL
 Objek pengontrol tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Pengontrol 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 sebelumnya selesai.
VDS_E_NOT_SUPPORTED
0x80042400L
 Operasi ini tidak didukung oleh penyedia ini.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 R2 [hanya aplikasi desktop]
Target Platform Windows
Header vdshwprv.h

Lihat juga

IEnumVdsObject

IVdsControllerControllerPort