SHFormatDrive 函式 (shlobj_core.h)

[SHFormatDrive 可用於需求一節中指定的操作系統。它可能會在後續版本中改變或無法使用。]

開啟殼層的 [ 格式 ] 對話框。

語法

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

[in] hwnd

類型： HWND

對話框之父視窗的句柄。 [ 格式 ] 對話框必須有父視窗;因此，此參數不可為 NULL。

drive

類型： UINT

要格式化的磁碟驅動器。此參數的值代表從 A：磁碟驅動器的 0 開始的字母磁碟驅動器。例如，值為 2 代表 C：磁碟驅動器。

fmtID

類型： UINT

實體格式的標識碼。目前只會定義下列旗標。

預設格式識別碼。

options

類型： UINT

此值必須是 0 或下列其中一個值，這些值會改變對話框中的預設格式選項。此值被視為位欄位，應據以處理。

0x001。如果已設定此旗標，則會選取 [ 快速格式 ] 選項。

此函式僅包含在具有SP1和更新版本的 Windows XP 中Shlobj.h 中。

Windowsxp： 在具有SP1的 Windows XP 之前，此函式可透過Shell32.lib存取。

0x002。選取 [建立 MS-DOS 啟動磁碟 ] 選項，建立系統開機磁碟。

類型： DWORD

傳回最後一個成功格式的格式識別碼或下列其中一個值。此值的 LOWORD 可以在後續呼叫上傳遞為 fmtID 參數，以重複最後一種格式。

格式是由對話框介面所控制。也就是說，用戶必須按兩下 [ 確定 ] 按鈕以實際開始格式—無法以程式設計方式啟動格式。

此對 SHFormatDrive 的呼叫會顯示磁碟驅動器 A 中磁碟的殼層格式對話框，並已選取預設格式設定選項。

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);