Metode IVdsVolumeMF3::FormatEx2 (vds.h)
[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 |
---|---|
|
Sistem file berhasil diformat. |
|
Operasi ditolak jika penelepon mencoba memformat sistem, boot, crashdump, hibernasi, atau volume pagefile. |
|
Volume gagal. |
|
Paket yang berisi volume tidak dapat diakses. Semua volume dalam paket offline tidak dapat diakses. |
|
Sistem file default tidak dapat ditentukan. |
Selain itu, antarmuka IVdsAsync dapat mengembalikan peringatan dan kode kesalahan terkait berikut.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Sistem file tidak kompatibel. |
|
Media tidak kompatibel. |
|
Akses ditolak. |
|
Media dilindungi terhadap penulisan. |
|
Label tidak valid. |
|
Volume tidak dapat diformat cepat. |
|
Terjadi kesalahan I/O selama format. |
|
Ukuran volume terlalu kecil untuk diformat. |
|
Ukuran volume terlalu besar untuk diformat. |
|
Ukuran kluster terlalu kecil untuk memungkinkan pemformatan. |
|
Ukuran kluster terlalu besar untuk memungkinkan pemformatan. |
|
Jumlah kluster terlalu besar untuk direpresentasikan sebagai bilangan bulat 32-bit. |
|
Sistem file diformat tetapi tidak dikompresi. |
|
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 |