Metode IVdsSubSystem::SetControllerStatus (vds.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Mengatur status (online atau offline) pengontrol di subsistem.
Sintaks
HRESULT SetControllerStatus(
[in] VDS_OBJECT_ID *pOnlineControllerIdArray,
[in] LONG lNumberOfOnlineControllers,
[in] VDS_OBJECT_ID *pOfflineControllerIdArray,
[in] LONG lNumberOfOfflineControllers
);
Parameter
[in] pOnlineControllerIdArray
Arahkan ke array GUID pengontrol. Penyedia menyetel pengontrol ini ke online. Array ini mencakup pengontrol yang sudah diatur ke online yang akan tetap demikian.
[in] lNumberOfOnlineControllers
Jumlah pengontrol yang ditentukan dalam pOnlineControllersArray.
[in] pOfflineControllerIdArray
Arahkan ke array GUID pengontrol. Penyedia menyetel pengontrol ini ke offline. Array ini mencakup pengontrol yang sudah diatur ke offline yang akan tetap demikian.
[in] lNumberOfOfflineControllers
Jumlah pengontrol yang ditentukan dalam pOfflineControllersArray.
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 |
---|---|
|
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 keadaan gagal dan tidak dapat melakukan operasi yang diminta. |
|
Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai. |
|
Dapat dikembalikan dari metode apa pun yang mengambil konstanta VDS_OBJECT_ID . Nilai pengembalian ini menunjukkan bahwa pengidentifikasi tidak merujuk ke objek yang ada. |
Keterangan
Metode ini memungkinkan penelepon untuk mengatur status semua pengontrol sekaligus. Gunakan metode IVdsController::SetStatus untuk mengatur status pengontrol tunggal.
Pemanggil harus melewati set pengontrol lengkap di parameter pOnlineControllerIdArray atau pOfflineControllerIdArray untuk setiap panggilan metode. Nilai E_INVALIDARG kembali dapat menunjukkan bahwa tidak semua pengontrol dalam subsistem telah ditentukan dalam argumen untuk metode ini.
Metode SetControllerStatus mengharuskan semua pengontrol dalam subsistem ada di salah satu dari dua array yang disediakan.
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 |