Metode IVdsDiskPartitionMF2::FormatPartitionEx2 (vds.h)

  • Artikel

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

Memformat OEM, ESP, atau partisi yang tidak diketahui yang ada. Metode ini identik dengan metode IVdsDiskPartitionMF::FormatPartition , kecuali bahwa opsi pemformatan ditentukan dengan menggunakan parameter Opsi .

Sintaks

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

Parameter

[in] ullOffset

Offset byte partisi dari awal disk. Offset ini harus menjadi offset awal partisi.

[in] pwszFileSystemTypeName

String Unicode yang dihentikan NULL yang berisi nama sistem file untuk memformat partisi. Harus NULL atau salah satu dari yang berikut: "NTFS", "FAT","FAT32", "UDF", atau "EXFAT". Jika parameter ini NULL, nilai 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 yang berisi label untuk ditetapkan ke sistem file baru untuk partisi. 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
 Volume berhasil dipartisi.
VDS_E_BAD_PROVIDER_DATA
0x80042441L
 Penyedia mengembalikan data yang buruk.
VDS_E_DISK_REMOVEABLE
0x8004255AL
 Operasi ini tidak didukung pada media yang dapat dilepas.
VDS_E_FS_NOT_DETERMINED
0x80042593L
 Sistem file default tidak dapat ditentukan.
VDS_E_MISSING_DISK
0x80042454L
 Disk hilang.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Partisi tidak ada.
VDS_E_PARTITION_NOT_OEM
0x8004256FL
 Operasi ini tidak didukung pada partisi non-OEM.
 

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_ACCESS_DENIED
0x80042427L
 Akses ditolak.
VDS_E_BAD_LABEL
0x80042429L
 Label tidak valid.
VDS_E_CANT_QUICK_FORMAT
0x8004242AL
 Volume tidak dapat diformat cepat.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS
0x80042430L
 Jumlah kluster terlalu besar untuk direpresentasikan sebagai bilangan bulat 32-bit.
VDS_E_CLUSTER_SIZE_TOO_BIG
0x8004242FL
 Ukuran kluster terlalu besar untuk memungkinkan pemformatan.
VDS_E_CLUSTER_SIZE_TOO_SMALL
0x8004242EL
 Ukuran kluster terlalu kecil untuk memungkinkan pemformatan.
VDS_E_INCOMPATIBLE_FILE_SYSTEM
0x80042425L
 Sistem file tidak kompatibel.
VDS_E_INCOMPATIBLE_MEDIA
0x80042426L
 Media tidak kompatibel.
VDS_E_IO_ERROR
0x8004242BL
 Terjadi kesalahan I/O selama format.
VDS_E_MEDIA_WRITE_PROTECTED
0x80042428L
 Media dilindungi terhadap penulisan.
VDS_E_VOLUME_TOO_BIG
0x8004242DL
 Ukuran volume terlalu besar untuk diformat.
VDS_E_VOLUME_TOO_SMALL
0x8004242CL
 Ukuran volume terlalu kecil untuk diformat.

Persyaratan

Persyaratan Nilai
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

Lihat juga

IVdsDiskPartitionMF2

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS