Funzione SHFormatDrive (shlobj_core.h)

[SHFormatDrive è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Apre la finestra di dialogo Formato della shell.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle della finestra padre della finestra di dialogo. La finestra di dialogo Formato deve avere una finestra padre; pertanto, questo parametro non può essere NULL.

drive

Tipo: UINT

Unità da formattare. Il valore di questo parametro rappresenta un'unità lettera a partire da 0 per l'unità A: Ad esempio, un valore pari a 2 corrisponde all'unità C:

fmtID

Tipo: UINT

ID del formato fisico. Solo il flag seguente è attualmente definito.

SHFMT_ID_DEFAULT (0xFFFF)

ID formato predefinito.

options

Tipo: UINT

Questo valore deve essere 0 o uno dei valori seguenti che modificano le opzioni di formato predefinite nella finestra di dialogo. Questo valore viene considerato come un campo di bit e deve essere trattato di conseguenza.

SHFMT_OPT_FULL (0x0001)

0x001. Se questo flag è impostato, è selezionata l'opzione Formato rapido .

Questa funzione è inclusa in Shlobj.h solo in Windows XP con SP1 e versioni successive.

Windows XP: Prima di Windows XP con SP1, questa funzione è accessibile tramite Shell32.lib.

SHFMT_OPT_SYSONLY (0x0002)

0x002. Seleziona l'opzione Crea un disco di avvio MS-DOS , creando un disco di avvio del sistema.

Valore restituito

Tipo: DWORD

Restituisce l'ID di formato dell'ultimo formato riuscito o uno dei valori seguenti. Il LOWORD di questo valore può essere passato alle chiamate successive come parametro fmtID per ripetere l'ultimo formato.

Commenti

Il formato è controllato dall'interfaccia della finestra di dialogo. Ovvero, l'utente deve fare clic sul pulsante OK per iniziare effettivamente il formato, il formato non può essere avviato a livello di codice.

Esempio

Questa chiamata a SHFormatDrive visualizza la finestra di dialogo Formato shell per un disco nell'unità A, con le opzioni di formattazione predefinite selezionate.

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);

Requisiti