IVdsVolumeMF::Metode format (vds.h)

  • Artikel

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

Memformat sistem file pada volume saat ini.

Sintaks

HRESULT Format(
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Parameter

[in] type

Nilai enumerasi VDS_FILE_SYSTEM_TYPE yang menentukan sistem file yang akan digunakan. Harus salah satu hal berikut: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, atau VDS_FST_UDF.

[in] pwszLabel

String yang mewakili label sistem file.

[in] dwUnitAllocationSize

Ukuran unit alokasi untuk sistem file dalam byte, yang biasanya antara 512 dan 65536.

[in] bForce

Jika TRUE, sistem file diformat tanpa syarat bahkan saat digunakan; jika tidak, operasi gagal.

[in] bQuickFormat

Jika TRUE, VDS melakukan format cepat (tidak memverifikasi setiap sektor pada volume).

[in] bEnableCompression

Jika TRUE, pemadatan diaktifkan pada sistem file yang baru diformat. Kompresi adalah fitur NTFS, dan diabaikan untuk FAT dan FAT32.

[out] ppAsync

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

Mengembalikan kode/nilai Deskripsi
S_OK
 Sistem file berhasil diformat.
VDS_E_OPERATION_DENIED
0x8004240AL
 Operasi ditolak jika penelepon mencoba memformat volume sistem, boot, crashdump, hibernation, atau pagefile.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Volume gagal.
VDS_E_PACK_OFFLINE
0x80042444L
 Paket yang berisi volume tidak dapat diakses. Semua volume dalam paket offline tidak dapat diakses.
 

Selain itu, antarmuka IVdsAsync dapat mengembalikan peringatan dan kode kesalahan terkait berikut.

Mengembalikan kode/nilai Deskripsi
VDS_S_VOLUME_COMPRESS_FAILED
0x00042443L
 Sistem file diformat tetapi tidak dikompresi.
VDS_E_INCOMPATIBLE_FILE_SYSTEM
0x80042425L
 Sistem file tidak kompatibel.
VDS_E_INCOMPATIBLE_MEDIA
0x80042426L
 Media tidak kompatibel.
VDS_E_ACCESS_DENIED
0x80042427L
 Akses ditolak.
VDS_E_MEDIA_WRITE_PROTECTED
0x80042428L
 Media dilindungi terhadap penulisan.
VDS_E_BAD_LABEL
0x80042429L
 Label tidak valid.
VDS_E_CANT_QUICK_FORMAT
0x8004242AL
 Volume tidak dapat diformat dengan cepat.
VDS_E_IO_ERROR
0x8004242BL
 Terjadi kesalahan IO selama format.
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
 Ukuran volume terlalu kecil untuk diformat.
VDS_E_VOLUME_TOO_BIG
0x8004242DL
 Ukuran volume terlalu besar untuk diformat.
VDS_E_CLUSTER_SIZE_TOO_SMALL
0x8004242EL
 Ukuran kluster terlalu kecil untuk memungkinkan pemformatan.
VDS_E_CLUSTER_SIZE_TOO_BIG
0x8004242FL
 Ukuran kluster terlalu besar untuk memungkinkan pemformatan.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS
0x80042430L
 Jumlah kluster terlalu besar untuk diwakili sebagai bilangan bulat 32-bit.
VDS_E_INVALID_FS_TYPE
0x80042561L
 Nilai parameter jenis tidak VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, atau VDS_FST_UDF.
VDS_E_CANT_INVALIDATE_FVE
0x80042592L
 Enkripsi BitLocker tidak dapat dinonaktifkan untuk volume.

Keterangan

Untuk membuat volume boot pada disk dinamis, Anda harus memanggil IVdsVolume::SetFlags untuk mengatur bendera VDS_VF_INSTALLABLE sebelum memanggil Format untuk memformat volume.

Jika partisi OEM diformat sebagai FAT atau FAT32, jenis partisi tidak berubah. Jika diformat dengan NTFS, jenis partisi berubah menjadi PARTITION_IFS (0x07). Untuk informasi tentang jenis partisi, lihat CREATE_PARTITION_PARAMETERS.

Jika metode ini dipanggil untuk volume yang dilindungi oleh enkripsi volume penuh BitLocker, enkripsi BitLocker dinonaktifkan untuk volume hingga pengguna mengaktifkannya kembali.

Untuk informasi selengkapnya tentang batas sistem file seperti ukuran unit alokasi minimum dan maksimum (juga disebut ukuran kluster), lihat Referensi Teknis NTFS dan Referensi Teknis FAT.

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

IVdsAsync

IVdsVolumeMF

VDS_FILE_SYSTEM_TYPE