Format-Methode der MSFT_Volume-Klasse

  • Artikel

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]

Die Dateisystembezeichnung für das Volume.

AllocationUnitSize [in]

Die Größe der Zuordnungseinheit in Byte.

Vollständig [in]

TRUE für ein vollständiges Format oder FALSE für ein Schnellformat.

Erzwingen von [in]

TRUE , um den Formatvorgang zu erzwingen; andernfalls FALSE.

Komprimieren [in]

TRUE , um das Volume zu komprimieren; andernfalls FALSE. Lassen Sie undefiniert, wenn FileSystem auf ReFS festgelegt ist.

ShortFileNameSupport [in]

TRUE , wenn das Volume Kurznamen unterstützen soll; andernfalls FALSE. Lassen Sie undefiniert, wenn FileSystem auf ReFS festgelegt ist.

SetIntegrityStreams [in]

TRUE , um Integritätsstreams festzulegen. Lassen Sie nicht definiert, es sei denn , FileSystem ist auf ReFS festgelegt.

UseLargeFRS [in]

TRUE , um große FRS zu verwenden; andernfalls FALSE. Lassen Sie undefiniert, wenn FileSystem auf ReFS festgelegt ist.

DisableHeatGathering [in]

TRUE , um die Wärmesammlung 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 ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.

Rückgabewert

Erfolg (0)

Nicht unterstützt (1)

Nicht angegebener Fehler (2)

Timeout (3)

Fehler (4)

Ungültiger Parameter (5)

Dieser Befehl wird unter x86, die in einer x64-Umgebung ausgeführt wird, nicht unterstützt. (7)

Zugriff verweigert (40001)

Unerwarteter E/A-Fehler ( 40004)

Das angegebene Objekt wird von der Komponente Microsoft-Failoverclustering verwaltet. Der Datenträger muss sich im Clusterwartungsmodus befinden, und die Clusterressource status muss online sein, um diesen Vorgang auszuführen. (40018)

Der Vorgang ist auf einem System oder einer kritischen Partition nicht zulässig. (42010)

Die angegebene Clustergröß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 Bits (43003)

Die angegebene UDF-Version wird nicht unterstützt (43004)

Die Clustergröße muss ein Vielfaches der physischen Sektorgröße des Datenträgers sein (43005).

Der angeforderte Vorgang kann nicht ausgeführt werden, 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

Weitere Informationen

MSFT_Volume