Format-Methode der MSFT_Volume-Klasse
Formatiert das Volume.
Syntax
UInt32 Format(
[in] String FileSystem,
[in] String FileSystemLabel,
[in] UInt32 AllocationUnitSize,
[in] Boolean Full,
[in] Boolean Force,
[in] Boolean Compress,
[in] Boolean ShortFileNameSupport,
[in] Boolean SetIntegrityStreams,
[in] Boolean UseLargeFRS,
[in] Boolean DisableHeatGathering,
[out] String FormattedVolume,
[out] String ExtendedStatus
);
Parameter
FileSystem [in]
Das Dateisystem, das auf das Volume angewendet werden soll. Einer der folgenden:
- „ExFAT“
- „FAT“
- „FAT32“
- „NTFS“
- „ReFS“
FileSystemLabel [in]
Das Label des Dateisystems für das Volume.
AllocationUnitSize [in]
Die Größe der Zuordnungseinheit in Bytes.
Full [in]
TRUE für eine vollständige Formatierung, oder FALSE für eine schnelle Formatierung.
Force [in]
TRUE, um den Vorgang der Formatierung zu erzwingen; andernfalls FALSE.
Compress [in]
TRUE, um das Volume zu komprimieren, andernfalls FALSE. Undefiniert lassen, wenn FileSystem auf ReFS festgelegt ist.
ShortFileNameSupport [in]
TRUE, wenn das Volume kurze Namen unterstützen soll, andernfalls FALSE. Undefiniert lassen, wenn FileSystem auf ReFS festgelegt ist.
SetIntegrityStreams [in]
TRUE, um Integritäts-Streams festzulegen. Undefiniert lassen, es sei denn FileSystem ist auf ReFS festgelegt.
UseLargeFRS [in]
TRUE, um große FRS zu verwenden; andernfalls FALSE. Undefiniert lassen, wenn FileSystem auf ReFS festgelegt ist.
DisableHeatGathering [in]
TRUE, um Heat Gathering zu deaktivieren, andernfalls FALSE.
FormattedVolume [out]
Empfängt ein MSFT_Volume Objekt, das das formatierte Volume darstellt.
ExtendedStatus [out]
Enthält ein eingebettetes MSFT_StorageExtendedStatus-Objekt.
Dieser Parameter bietet dem Speicheranbieter die Möglichkeit, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Success (0)
Nicht unterstützt (1)
Unspezifischer Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Dieser Befehl wird unter x86 nicht unterstützt, wenn er in einer x64-Umgebung ausgeführt wird. (7)
Access Denied (40001)
Ein unerwarteter E/A-Fehler ist aufgetreten (40004)
Das angegebene Objekt wird von der Microsoft Failover Clustering Komponente verwaltet. Der Datenträger muss sich im Cluster-Wartungsmodus befinden und der Status der Cluster-Ressourcen muss online sein, um diesen Vorgang durchzuführen. -40018
Der Vorgang ist auf einer Systempartition oder einer kritischen Partition nicht zulässig. -42010
Die angegebene Cluster-Größe ist ungültig (43000)
Das angegebene Dateisystem wird nicht unterstützt (43001)
Das Volume kann nicht schnell formatiert werden (43002)
Die Anzahl der Cluster überschreitet 32 Bit (43003)
Die angegebene UDF-Version wird nicht unterstützt (43004)
Die Cluster-Größe muss ein Vielfaches der physischen Sektorgröße des Datenträgers sein (43005)
Kann den angeforderten Vorgang nicht ausführen, wenn das Laufwerk schreibgeschützt ist (43006)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |