IVdsHwProvider::Metode refresh (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.]

Merefresh data VDS yang di-cache secara internal tentang subsistem yang ada yang dikelola oleh penyedia VDS.

Sintaks

HRESULT Refresh();

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. 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_STATUS_FAILED 0x80042431L	Penyedia 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.
VDS_E_INITIALIZE_NOT_CALLED 0x80042402L	Metode inisialisasi belum dipanggil.

Keterangan

VDS mempertahankan cache informasi tentang properti semua objek VDS, seperti subsistem dan pengontrol. Setiap kali perubahan terjadi yang memicu pemberitahuan, cache ini diperbarui. Dalam kasus di mana cache tidak diperbarui dengan benar, aplikasi dapat memanggil metode ini untuk menyegarkan cache. Perhatikan bahwa memanggil metode ini untuk menyegarkan cache pada gilirannya dapat memicu pemberitahuan tambahan.

Metode ini tidak meminta jaringan untuk menemukan subsistem yang baru tersambung. Untuk menemukan subsistem yang baru tersambung dan terputus, gunakan metode IVdsHwProvider::Reenumerate .

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

Lihat juga

IVdsHwProvider

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

Bagikan melalui