IVdsSubSystem::Hitung ulang metode (vdshwprv.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]
Meminta subsistem untuk memindai busnya untuk menemukan drive yang baru tersambung atau drive yang baru terputus.
Sintaks
HRESULT Reenumerate();
Mengembalikan nilai
Metode ini dapat mengembalikan nilai HRESULT standar, seperti 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 |
|---|---|
|
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. |
|
Objek subsistem tidak ada lagi. |
|
Subsistem dalam status gagal dan tidak dapat melakukan operasi yang diminta. |
|
Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai. |
Keterangan
Sebagian besar subsistem mendeteksi koneksi baru dan pemutusan sambungan secara otomatis. Namun, bagi mereka yang tidak, metode ini menyediakan sarana untuk memulai deteksi secara manual. Operasi ini dapat memakan waktu lama untuk diselesaikan.
Ketika metode ini mendeteksi drive yang baru tersambung, penyedia membuat objek drive baru untuk itu. Ketika metode mendeteksi drive yang baru terputus, penyedia mempertahankan objek drive lama hingga referensi VDS terakhir dihapus, lalu menghapus objek.
Setiap objek harus memiliki pengidentifikasi unik dan persisten. ID objek harus berupa GUID yang valid. Pelaksana harus mempertahankan ID objek di setiap reenumerasi dengan menggunakan metode ini untuk objek yang ada baik sebelum dan sesudah reenumerasi.
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 |