Metode IVdsVolumeMF3::FormatEx2 (vds.h)

  • Artikel

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

Memformat volume sistem file pada partisi. Metode ini identik dengan metode IVdsVolumeMF2::FormatEx , kecuali bahwa opsi pemformatan ditentukan dengan menggunakan parameter Opsi .

Sintaks

HRESULT FormatEx2(
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  DWORD     Options,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] pwszFileSystemTypeName

String Unicode yang dihentikan null yang berisi nama sistem file untuk memformat volume. Parameter ini bisa NULL atau nama sistem file Windows. Sistem file berikut didukung: "NTFS", "FAT", "FAT32", "UDF", dan "EXFAT". Jika parameter ini NULL, sistem file default akan digunakan. Untuk informasi selengkapnya, lihat VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

Revisi sistem file, jika ada. Anggota ini dinyatakan sebagai angka desimal berkode biner 16-bit, di mana titik desimal tersirat antara digit kedua dan ketiga. Misalnya, nilai 0x0250 menunjukkan revisi 2,50.

[in] ulDesiredUnitAllocationSize

Ukuran unit alokasi untuk sistem file, dalam byte. Nilai haruslah kekuatan 2. Jika nilainya adalah 0, unit alokasi default yang ditentukan oleh jenis sistem file akan digunakan. Rentang unit alokasi bergantung pada sistem file.

[in] pwszLabel

String Unicode yang dihentikan null untuk ditetapkan ke sistem file baru. Ukuran label maksimum tergantung pada sistem file.

[in] Options

Bitmask dari nilai enumerasi VDS_FORMAT_OPTION_FLAGS yang menentukan opsi pemformatan.

[out] ppAsync

Penunjuk ke antarmuka IVdsAsync yang setelah berhasil diselesaikan menerima antarmuka IVdsAsync untuk memantau dan mengontrol operasi ini. Penelepon harus merilis antarmuka yang diterima ketika mereka selesai dengannya.

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.

Mengembalikan kode/nilai Deskripsi
S_OK
0x00000000L
 Sistem file berhasil diformat.
VDS_E_OPERATION_DENIED
0x8004240AL
 Operasi ditolak jika penelepon mencoba memformat sistem, boot, crashdump, hibernasi, atau volume 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.
VDS_E_FS_NOT_DETERMINED
0x80042593L
 Sistem file default tidak dapat ditentukan.
 

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

Mengembalikan kode/nilai Deskripsi
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 cepat.
VDS_E_IO_ERROR
0x8004242BL
 Terjadi kesalahan I/O 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 direpresentasikan sebagai bilangan bulat 32-bit.
VDS_S_VOLUME_COMPRESS_FAILED
0x00042443L
 Sistem file diformat tetapi tidak dikompresi.
VDS_E_CANT_INVALIDATE_FVE
0x80042592L
 Enkripsi BitLocker tidak dapat dinonaktifkan untuk volume.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header vds.h
Pustaka Uuid.lib

Lihat juga

IVdsVolumeMF2::FormatEx

IVdsVolumeMF3

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS