Metode IVdsService::CleanupObsoleteMountPoints (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Menghapus jalur mode pengguna dan folder yang dipasang untuk volume yang sudah tidak ada lagi.

Sintaks

HRESULT CleanupObsoleteMountPoints();

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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai Deskripsi
S_OK
 Jalur mode pengguna yang sudah kedaluarsa dan folder yang dipasang berhasil dihapus.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir sampai inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

Keterangan

Secara default, registri mempertahankan informasi pemetaan drive-letter untuk volume yang dihapus instalasinya. Jika disk yang berisi volume dihapus dari komputer, entri registri dipertahankan, sehingga jika disk dan volume kembali ke komputer yang sama, volume menerima huruf drive yang sama. Jika disk dipindahkan ke komputer baru, entri registri tidak berpindah dengannya, sehingga volume mungkin menerima huruf drive dan GUID volume yang berbeda.

Metode CleanupObsoleteMountPoints menghapus entri registri ini. Ada tiga jenis entri registri yang dihapus:

  • Jika volume tidak memiliki huruf kandar atau GUID volume, volume tersebut memiliki entri registri "tidak ada huruf drive", yang dihapus oleh metode ini.
  • Jika tidak, volume memiliki entri registri untuk GUID volume dan mungkin huruf kandar. Keduanya dihapus oleh metode ini.
Selain itu, jika volume berisi folder yang dipasang, CleanupObsoleteMountPoints akan menghapusnya. Misalnya, jika Volume1 pada Disk1 sedang dihapus dan Volume1 dipasang sebagai x:\MountVolume1 pada Disk2, folder \MountVolume1 pada Disk2 juga dihapus.

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

Lihat juga

IVdsService