Metode IVdsVolume::D elete (vds.h)

  • Artikel

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

Menghapus volume dan semua pleks, melepaskan jangkauannya.

Sintaks

HRESULT Delete(
  [in] BOOL bForce
);

Parameter

[in] bForce

Jika TRUE, VDS akan menghapus volume meskipun sedang digunakan; jika tidak, volume tidak dihapus jika sedang digunakan.

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.

Menampilkan kode Deskripsi
S_OK
 Pleks berhasil dihapus.

Keterangan

Anda hanya dapat menghapus volume dari paket online. Gunakan metode IVdsPack::GetProperties untuk mengonfirmasi bahwa status paket VDS_PS_ONLINE.

Anda tidak dapat menghapus volume yang ada pada media yang bisa dilepas.

VDS melepas sistem file sebelum menghapus volume—operasi yang diperlukan oleh FAT dan FAT32, tetapi bukan NTFS. Selain itu, VDS menghapus semua jalur akses ke volume setelah menghapus volume itu sendiri. Jika operasi melepas gagal, dan bForcebenar, VDS menghapus volume tanpa melepas. Aplikasi klien sistem file harus menangani situasi ini. Jika pembuangan berhasil, dan operasi penghapusan gagal, VDS mencoba memasang ulang volume.

VDS mencegah penghapusan volume sistem dan boot saat ini, serta volume pagefile, crashdump, dan hibernasi. Anda dapat memindahkan atau mengatur ulang crashdump dan pagefile. Volume hibernasi harus tetap berada di partisi boot.

Windows Server 2003: Volume crashdump dan hibernasi harus tetap berada di partisi boot.

Windows Server 2003: Setelah volume dihapus, VDS mencoba menghapus folder yang dipasang. Jika ini gagal, Hapus akan mengembalikan VDS_S_ACCESS_PATH_NOT_DELETED, meskipun volume berhasil dihapus.

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

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS