IVdsVolumeMF2::FormatEx-Methode (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Formatiert ein Dateisystemvolume auf einer Partition.

Syntax

HRESULT FormatEx(
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  BOOL      bForce,
  [in]  BOOL      bQuickFormat,
  [in]  BOOL      bEnableCompression,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] pwszFileSystemTypeName

Unicode-Zeichenfolge mit Null-Endung, die den Namen des Dateisystems enthält, mit dem das Volume formatiert werden soll. Dieser Parameter kann NULL oder der Name eines Windows-Dateisystems sein. Die folgenden Dateisysteme werden unterstützt: "NTFS", "FAT", "FAT32", "UDF" und "EXFAT". Wenn dieser Parameter NULL ist, wird das Standarddateisystem verwendet. Weitere Informationen finden Sie unter VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

Die Revision des Dateisystems, falls vorhanden. Dieses Element wird als 16-Bit-binärcodierte Dezimalzahl ausgedrückt, wobei zwischen der zweiten und dritten Ziffer ein Dezimalpunkt impliziert wird. Ein Wert von 0x0250 gibt beispielsweise die Version 2.50 an.

[in] ulDesiredUnitAllocationSize

Die Größe der Zuordnungseinheit für das Dateisystem in Bytes. Der Wert muss eine Leistung von 2 sein. Wenn der Wert 0 ist, wird eine Standardzuordnungseinheit verwendet, die vom Dateisystemtyp bestimmt wird. Der Bereich der Zuordnungseinheit ist dateisystemabhängig.

[in] pwszLabel

Unicode-Zeichenfolge mit Null-Endung, die dem neuen Dateisystem zugewiesen werden soll. Die maximale Bezeichnungsgröße ist dateisystemabhängig.

[in] bForce

Boolesch, der bestimmt, ob ein Dateisystemformat erzwungen wird, unabhängig davon, ob die Partition verwendet wird.

[in] bQuickFormat

Boolesch, der bestimmt, ob ein Dateisystemvolume schnell formatiert ist. Ein Schnellformat überprüft nicht jeden Sektor auf dem Volume.

[in] bEnableCompression

Boolesch, der bestimmt, ob das Dateisystemvolume mit aktivierter Komprimierung erstellt wird.

Hinweis Dieser Parameter wird ignoriert, wenn das Dateisystem nicht NTFS ist.

[out] ppAsync

Zeiger auf eine IVdsAsync-Schnittstelle , die nach erfolgreichem Abschluss die IVdsAsync-Schnittstelle empfängt, um diesen Vorgang zu überwachen und zu steuern. Aufrufer müssen die empfangene Schnittstelle freigeben, wenn sie damit fertig sind.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0x00000000L	Das Dateisystem wurde erfolgreich formatiert.
VDS_E_OPERATION_DENIED 0x8004240AL	Der Vorgang wird verweigert, wenn der Aufrufer versucht, das System-, Start-, Absturzdump-, Ruhezustands- oder Seitendateivolume zu formatieren.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Fehler beim Volume.
VDS_E_PACK_OFFLINE 0x80042444L	Auf das Paket, das das Volume enthält, kann nicht zugegriffen werden. Auf alle Volumes in einem Offlinepaket kann nicht zugegriffen werden.
VDS_E_FS_NOT_DETERMINED 0x80042593L	Das Standarddateisystem konnte nicht bestimmt werden.

Darüber hinaus kann die IVdsAsync-Schnittstelle die folgenden zugehörigen Warnungen und Fehlercodes zurückgeben:

Rückgabecode/-wert	Beschreibung
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	Das Dateisystem ist inkompatibel.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	Die Medien sind nicht kompatibel.
VDS_E_ACCESS_DENIED 0x80042427L	Zugriff verweigert.“
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Das Medium ist schreibgeschützt.
VDS_E_BAD_LABEL 0x80042429L	Die Bezeichnung ist ungültig.
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	Das Volume kann nicht schnell formatiert werden.
VDS_E_IO_ERROR 0x8004242BL	Während des Formats ist ein E/A-Fehler aufgetreten.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	Die Volumegröße ist zu klein zum Formatieren.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	Die Volumegröße ist zu groß für die Formatierung.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	Die Clustergröße ist zu klein, um Formatierungen zuzulassen.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	Die Clustergröße ist zu groß, um Formatierungen zuzulassen.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	Die Anzahl der Cluster ist zu groß, um als ganze 32-Bit-Zahl dargestellt zu werden.
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	Das Dateisystem ist formatiert, aber nicht komprimiert.
VDS_E_CANT_INVALIDATE_FVE 0x80042592L	Die BitLocker-Verschlüsselung konnte für das Volume nicht deaktiviert werden.

Hinweise

Wenn eine OEM-Partition als FAT oder FAT32 formatiert ist, ändert sich der Partitionstyp nicht. Wenn er mit NTFS formatiert ist, ändert sich der Partitionstyp in PARTITION_IFS (0x07). Informationen zu Partitionstypen finden Sie unter CREATE_PARTITION_PARAMETERS.

Wenn diese Methode für ein Volume aufgerufen wird, das durch die BitLocker-Vollvolumeverschlüsselung geschützt ist, wird die BitLocker-Verschlüsselung für das Volume deaktiviert, bis der Benutzer es erneut aktiviert.

Weitere Informationen zu Dateisystemgrenzwerten wie der minimalen und maximalen Größe der Zuordnungseinheiten (auch als Clustergröße bezeichnet) finden Sie unter Technische Referenz zu NTFS und FAT Technical Reference.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h
Bibliothek	Uuid.lib

Weitere Informationen

IVdsVolumeMF2

Freigeben über