Bagikan melalui

Fungsi SHFormatDrive (shlobj_core.h)

  • Artikel

[SHFormatDrive tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Membuka kotak dialog Format Shell.

Sintaks

DWORD SHFormatDrive(
  [in] HWND hwnd,
       UINT drive,
       UINT fmtID,
       UINT options
);

Parameter

[in] hwnd

Jenis: HWND

Gagang jendela induk kotak dialog. Kotak dialog Format harus memiliki jendela induk; oleh karena itu, parameter ini tidak boleh NULL.

drive

Jenis: UINT

Drive yang akan diformat. Nilai parameter ini mewakili drive huruf mulai dari 0 untuk drive A: . Misalnya, nilai 2 adalah singkatan dari drive C: .

fmtID

Jenis: UINT

ID format fisik. Hanya bendera berikut yang saat ini ditentukan.

SHFMT_ID_DEFAULT (0xFFFF)

ID format default.

options

Jenis: UINT

Nilai ini harus 0 atau salah satu nilai berikut yang mengubah opsi format default dalam kotak dialog. Nilai ini dianggap sebagai bitfield dan harus diperlakukan sesuai.

SHFMT_OPT_FULL (0x0001)

0x001. Jika bendera ini diatur, maka opsi Format Cepat dipilih.

Fungsi ini disertakan dalam Shlobj.h hanya di Windows XP dengan SP1 dan yang lebih baru.

Windows XP: Sebelum Windows XP dengan SP1, fungsi ini dapat diakses melalui Shell32.lib.

SHFMT_OPT_SYSONLY (0x0002)

0x002. Memilih opsi Buat disk startup MS-DOS , membuat disk boot sistem.

Nilai kembali

Jenis: DWORD

Mengembalikan ID format dari format terakhir yang berhasil atau salah satu nilai berikut. LOWORD dari nilai ini dapat diteruskan pada panggilan berikutnya sebagai parameter fmtID untuk mengulangi format terakhir.

Menampilkan kode Deskripsi
SHFMT_ERROR
 Terjadi kesalahan selama format terakhir. Ini tidak menunjukkan bahwa drive tidak dapat diformat.
SHFMT_CANCEL
 Format terakhir dibatalkan.
SHFMT_NOFORMAT
 Kandar tidak dapat diformat.

Keterangan

Format dikontrol oleh antarmuka kotak dialog. Artinya, pengguna harus mengklik tombol OK untuk benar-benar memulai format—format tidak dapat dimulai secara terprogram.

Contoh

Panggilan ke SHFormatDrive ini memunculkan kotak dialog Format Shell untuk disk di drive A, dengan opsi pemformatan default dipilih.

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlobj_core.h (termasuk Shlobj.h)
Pustaka Shell32.lib
DLL Shell32.dll (versi 5.0 atau yang lebih baru)