SHFormatDrive-Funktion (shlobj_core.h)

[SHFormatDrive ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Öffnet das Dialogfeld Format der Shell.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Das Handle des übergeordneten Fensters des Dialogfelds. Das Dialogfeld Format muss über ein übergeordnetes Fenster verfügen. Daher kann dieser Parameter nicht NULL sein.

drive

Typ: UINT

Das zu formatierende Laufwerk. Der Wert dieses Parameters stellt ein Buchstabenlaufwerk ab 0 für das Laufwerk A: dar. Ein Wert von 2 steht beispielsweise für das Laufwerk C: .

fmtID

Typ: UINT

Die ID des physischen Formats. Derzeit ist nur das folgende Flag definiert.

SHFMT_ID_DEFAULT (0xFFFF)

Die Standardformat-ID.

options

Typ: UINT

Dieser Wert muss 0 oder einer der folgenden Werte sein, die die Standardformatoptionen im Dialogfeld ändern. Dieser Wert wird als Bitfeld betrachtet und sollte entsprechend behandelt werden.

SHFMT_OPT_FULL (0x0001)

0x001. Wenn dieses Flag festgelegt ist, ist die Option Schnellformatierung ausgewählt.

Diese Funktion ist in Shlobj.h nur in Windows XP mit SP1 und höher enthalten.

Windows XP: Vor Windows XP mit SP1 kann auf diese Funktion über Shell32.lib zugegriffen werden.

SHFMT_OPT_SYSONLY (0x0002)

0x002. Wählt die Option Ms-DOS-Startdatenträger erstellen aus, und erstellt einen Systemstartdatenträger.

Rückgabewert

Art: DWORD

Gibt die Format-ID des letzten erfolgreichen Formats oder eines der folgenden Werte zurück. Der LOWORD dieses Werts kann bei nachfolgenden Aufrufen als fmtID-Parameter übergeben werden, um das letzte Format zu wiederholen.

Rückgabecode	Beschreibung
SHFMT_ERROR	Beim letzten Format ist ein Fehler aufgetreten. Dies bedeutet nicht, dass das Laufwerk nicht formatiert ist.
SHFMT_CANCEL	Das letzte Format wurde abgebrochen.
SHFMT_NOFORMAT	Das Laufwerk kann nicht formatiert werden.

Hinweise

Das Format wird von der Dialogfeldschnittstelle gesteuert. Das heißt, der Benutzer muss auf die Schaltfläche OK klicken, um das Format tatsächlich zu starten. Das Format kann nicht programmgesteuert gestartet werden.

Beispiele

Durch diesen Aufruf von SHFormatDrive wird das Dialogfeld Format der Shell für einen Datenträger in Laufwerk A geöffnet, wobei die Standardformatierungsoptionen ausgewählt sind.

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 5.0 oder höher)