IVdsDiskPartitionMF::FormatPartitionEx-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 eine vorhandene OEM-, ESP- oder unbekannte Partition.

Syntax

HRESULT FormatPartitionEx(
  [in]  ULONGLONG ullOffset,
  [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] ullOffset

Byteoffset der Partition vom Anfang des Datenträgers. Dieser Offset muss der Offset des Anfangs einer Partition sein.

[in] pwszFileSystemTypeName

Eine MIT NULL beendete Unicode-Zeichenfolge, die den Namen des Dateisystems enthält, mit dem die Partition formatiert werden soll. Muss NULL oder eine der folgenden Werte sein: "NTFS", "FAT", "FAT32", "UDF" oder "EXFAT". Wenn dieser Parameter NULL ist, wird ein Standardwert verwendet.

[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 für das Volume 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 ein Dateisystem 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	Das Volume wurde erfolgreich partitioniert.
VDS_E_BAD_PROVIDER_DATA 0x80042441L	Ein Anbieter hat fehlerhafte Daten zurückgegeben.
VDS_E_DISK_REMOVEABLE 0x8004255AL	Der Vorgang wird auf Wechselmedien nicht unterstützt.
VDS_E_FS_NOT_DETERMINED 0x80042593L	Das Standarddateisystem konnte nicht bestimmt werden.
VDS_E_MISSING_DISK 0x80042454L	Der Datenträger fehlt.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Die Partition ist nicht vorhanden.
VDS_E_PARTITION_NOT_OEM 0x8004256FL	Der Vorgang wird auf Nicht-OEM-Partitionen nicht unterstützt.

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

Rückgabecode/-wert	BESCHREIBUNG
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	Das Dateisystem ist formatiert, aber nicht komprimiert.
VDS_E_ACCESS_DENIED 0x80042427L	Zugriff verweigert.“
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_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	Die Anzahl der Cluster ist zu groß, um als ganze 32-Bit-Zahl dargestellt zu werden.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	Die Clustergröße ist zu groß, um Formatierungen zuzulassen.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	Die Clustergröße ist zu klein, um Formatierungen zuzulassen.
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	Das Dateisystem ist inkompatibel.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	Die Medien sind nicht kompatibel.
VDS_E_IO_ERROR 0x8004242BL	Während des Formats ist ein E/A-Fehler aufgetreten.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Das Medium ist schreibgeschützt.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	Die Volumegröße ist zu groß für die Formatierung.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	Die Volumegröße ist zu klein zum Formatieren.

Hinweise

Diese Methode formatiert nur OEM-, ESP- und unbekannte Partitionen. Für andere Partitionen müssen Sie stattdessen das entsprechende Volume mit der IVdsVolumeMF::Format - oder IVdsVolumeMF2::FormatEx-Methode formatieren. Beachten Sie, dass OEM-, ESP- und unbekannte Partitionen nicht als Volumes verfügbar gemacht werden und daher nicht mit Format oder FormatEx formatiert werden können.

Diese Methode kann nicht zum Formatieren von Wechselmedien verwendet werden.

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.

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

Anforderung	Wert
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

IVdsAdvancedDisk::FormatPartition

IVdsDiskPartitionMF

Freigeben über