IVdsVolumeMF::Metode format (vds.h)

Artikel
03/08/2023

[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

Bagikan melalui