IVdsAdvancedDisk::Metode bersih (vds.h)

  • Artikel

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

Menghapus informasi partisi dan menghapus inisialisasi disk dasar atau dinamis.

Windows Server 2003: Metode Bersihkan tidak didukung untuk perangkat yang dapat dilepas.

Sintaks

HRESULT Clean(
  [in]  BOOL      bForce,
  [in]  BOOL      bForceOEM,
  [in]  BOOL      bFullClean,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] bForce

Jika TRUE, membersihkan disk yang berisi volume data atau partisi ESP.

[in] bForceOEM

Jika TRUE, membersihkan disk berbasis MBR yang berisi partisi OEM yang diketahui dalam tabel berikut atau membersihkan disk berbasis GPT yang berisi partisi OEM apa pun. Partisi OEM memiliki bendera GPT_ATTRIBUTE_PLATFORM_REQUIRED yang diatur pada disk berbasis GPT.

Jenis partisi Deskripsi
0x12 Partisi EISA.
0x84 Partisi hibernasi untuk laptop.
0xA0 Partisi diagnostik untuk beberapa laptop HP.
0xDE Partisi yang ditentukan oleh Dell.
0xFE Partisi IBM IML.

[in] bFullClean

Jika TRUE, membersihkan seluruh disk dengan mengganti data pada setiap sektor dengan nol; jika tidak, metode ini hanya membersihkan megabyte pertama dan terakhir pada disk.

[out] ppAsync

Alamat penunjuk ke penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan penunjuk ini untuk membatalkan, menunggu, atau mengkueri status operasi.

Nilai kembali

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
S_OK
 Data berhasil dihapus dan disk tidak diinisialisasi.
VDS_E_NO_MEDIA
0x80042412L
 Tidak ada media di perangkat yang bisa dilepas.
VDS_E_MISSING_DISK
0x80042454L
 Disk hilang.
VDS_E_OPERATION_DENIED
0x8004240AL
 Operasi gagal dalam salah satu kondisi berikut:
  • Disk berisi partisi OEM dan bForceOEM adalah false.
  • Disk berisi partisi volume atau ESP dan bForceadalah FALSE.
  • Disk berisi salah satu volume sistem terlepas dari apakah bForceTRUE atau FALSE. Volume sistem dapat berupa salah satu item berikut:
    • Volume yang berisi pemuat sistem operasi.
    • Volume boot, yang berisi direktori system32.
    • Volume yang berisi file pagefile atau hibernasi, atau volume yang digunakan sebagai crash dump.
    • Partisi ESP (partisi tempat sistem melakukan booting).
VDS_S_DISK_PARTIALLY_CLEANED
0x0004241AL
 Tabel partisi dibersihkan, tetapi tidak semua sektor dibersihkan selama bersih penuh. Atau, beberapa sektor megabyte pertama dan megabyte terakhir dibersihkan; namun, kecuali bersih adalah bersih penuh, sektor yang tersisa tidak dibersihkan.

Keterangan

Sebelum memanggil metode ini, pemanggil harus melepas volume yang dipasang pada disk dengan memanggil IVdsVolumeMF::D ismount untuk setiap volume.

Gunakan parameter bForce , parameter bForceOEM , atau keduanya dengan metode ini kecuali Anda terlebih dahulu menghapus semua volume data, partisi OEM yang diketahui, dan partisi ESP pada disk. Persyaratan ini mengecualikan partisi metadata seperti MSR, partisi metadata LDM, dan partisi OEM yang tidak diketahui.

Windows Server 2003: Metode Bersihkan tidak didukung untuk perangkat yang dapat dilepas.

Pelaksana harus mengembalikan penunjuk ke antarmuka IVdsAsync untuk metode ini, terlepas dari apakah panggilan memulai operasi asinkron.

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

Objek Disk

IVdsAdvancedDisk

IVdsAsync