IVdsService::Metode refresh (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Menyegarkan informasi kepemilikan disk dan tata letak disk.

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
S_OK
 Metode berhasil diselesaikan.
S_FALSE
 Terjadi kesalahan selama operasi ini.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir hingga inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Metode ini menyinkronkan tata letak disk ke tata letak yang diketahui oleh driver disk. Ini tidak memaksa driver untuk membaca tata letak dari disk. Selain itu, metode ini me-refresh tampilan semua objek dalam cache VDS. VDS dan penyedia mengkueri semua objek, mengirim kedatangan objek, modifikasi, menghapus pemberitahuan untuk menyinkronkan pemanggil. Perhatikan bahwa VDS memperbarui cache secara otomatis setiap kali mendeteksi perubahan yang memicu pemberitahuan. Untuk alasan ini, dan karena memanggil Refresh dapat memicu pemberitahuan tambahan, aplikasi tidak boleh memanggil metode ini sebagai respons terhadap pemberitahuan. Refresh harus dipanggil hanya ketika muncul bahwa cache tidak diperbarui dengan benar.

Persyaratan

   
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

Lihat juga

IVdsService