Metode IVdsController::SetStatus (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.]

Mengatur status pengontrol ke nilai yang ditentukan.

Sintaks

HRESULT SetStatus(
  [in] VDS_CONTROLLER_STATUS status
);

Parameter

[in] status

Nilai yang dijumlahkan oleh VDS_CONTROLLER_STATUS. Penelepon dapat meneruskan subset dari kemungkinan nilai enumerasi. Meneruskan VDS_CS_UNKNOWN mengembalikan E_INVALIDARG.

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 pengontrol tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Pengontrol dalam status 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.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi atau kombinasi parameter ini tidak didukung oleh penyedia ini.

Keterangan

Metode ini memungkinkan Anda untuk mengatur status pengontrol tunggal. Anda dapat mengatur status semua pengontrol dalam subsistem sekaligus dengan memanggil metode IVdsSubSystem::SetControllerStatus . Gunakan metode IVdsController::GetProperties untuk mendapatkan status pengontrol saat ini.

Pelaksana bertanggung jawab untuk melakukan operasi yang diperlukan untuk mendapatkan status ke status yang ditentukan. Misalnya, jika penelepon meneruskan VDS_CS_OFFLINE sebagai status pengontrol, Anda mungkin perlu terlebih dahulu menghapus cache untuk pengontrol.

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