Metode IVdsDiskPartitionMF::FormatPartitionEx (vds.h)
[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.
Sintaks
HRESULT FormatPartitionEx(
[in] ULONGLONG ullOffset,
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] BOOL bForce,
[in] BOOL bQuickFormat,
[in] BOOL bEnableCompression,
[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.
[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 untuk volume. Ukuran label maksimum tergantung pada sistem file.
[in] bForce
Boolean yang menentukan apakah format sistem file dipaksakan, terlepas dari apakah partisi sedang digunakan.
[in] bQuickFormat
Boolean yang menentukan apakah volume sistem file diformat cepat. Format cepat tidak memverifikasi setiap sektor pada volume.
[in] bEnableCompression
Boolean yang menentukan apakah sistem file akan dibuat dengan pemadatan diaktifkan.
[out] ppAsync
Arahkan 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 |
---|---|
|
Volume berhasil dipartisi. |
|
Penyedia mengembalikan data yang buruk. |
|
Operasi ini tidak didukung pada media yang dapat dilepas. |
|
Sistem file default tidak dapat ditentukan. |
|
Disk hilang. |
|
Partisi tidak ada. |
|
Operasi ini tidak didukung pada partisi non-OEM. |
Selain itu, antarmuka IVdsAsync dapat mengembalikan peringatan dan kode kesalahan terkait berikut.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Sistem file diformat tetapi tidak dikompresi. |
|
Akses ditolak. |
|
Label tidak valid. |
|
Volume tidak dapat diformat cepat. |
|
Jumlah kluster terlalu besar untuk direpresentasikan sebagai bilangan bulat 32-bit. |
|
Ukuran kluster terlalu besar untuk memungkinkan pemformatan. |
|
Ukuran kluster terlalu kecil untuk memungkinkan pemformatan. |
|
Sistem file tidak kompatibel. |
|
Media tidak kompatibel. |
|
Terjadi kesalahan I/O selama format. |
|
Media dilindungi terhadap penulisan. |
|
Ukuran volume terlalu besar untuk diformat. |
|
Ukuran volume terlalu kecil untuk diformat. |
Keterangan
Metode ini hanya memformat OEM, ESP, dan partisi yang tidak diketahui. Untuk partisi lain, Anda harus memformat volume yang sesuai dengan menggunakan metode IVdsVolumeMF::Format atau IVdsVolumeMF2::FormatEx . Perhatikan bahwa OEM, ESP, dan partisi yang tidak diketahui tidak diekspos sebagai volume dan oleh karena itu tidak dapat diformat dengan Format atau FormatEx.
Metode ini tidak dapat digunakan untuk memformat media yang bisa dilepas.
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.
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
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | vds.h |
Pustaka | Uuid.lib |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk