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.
Codice restituito | Descrizione |
---|---|
|
Errore durante l'ultimo formato. Questo non indica che l'unità non è formattata. |
|
L'ultimo formato è stato annullato. |
|
Impossibile formattare l'unità. |
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
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlobj_core.h (include Shlobj.h) |
Libreria | Shell32.lib |
DLL | Shell32.dll (versione 5.0 o successiva) |