IVdsDiskPartitionMF2::FormatPartitionEx2-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 abgelöst.]

Formatiert eine vorhandene OEM-, ESP- oder unbekannte Partition. Diese Methode ist identisch mit der IVdsDiskPartitionMF::FormatPartition-Methode , mit der Ausnahme, dass Formatierungsoptionen mithilfe des Options-Parameters angegeben werden.

Syntax

HRESULT FormatPartitionEx2(
  [in]  ULONGLONG ullOffset,
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  DWORD     Options,
  [out] IVdsAsync **ppAsync
);

Parameter

[in] ullOffset

Der 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. Weitere Informationen finden Sie unter VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.

[in] usFileSystemRevision

Die Revision des Dateisystems, falls vorhanden. Dieser Member wird als binärcodierte 16-Bit-Dezimalzahl ausgedrückt, wobei ein Dezimaltrennzeichen zwischen der zweiten und dritten Ziffer impliziert wird. Beispielsweise gibt der Wert 0x0250 Revision 2,50 an.

[in] ulDesiredUnitAllocationSize

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

[in] pwszLabel

Eine MIT NULL beendete Unicode-Zeichenfolge, die die Bezeichnung enthält, die dem neuen Dateisystem für die Partition zugewiesen werden soll. Die maximale Bezeichnungsgröße ist vom Dateisystem abhängig.

[in] Options

Eine Bitmaske mit VDS_FORMAT_OPTION_FLAGS Enumerationswerten, die Formatierungsoptionen angeben.

[out] ppAsync

Ein 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 makros HRESULT_FROM_WIN32 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 für 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 32-Bit-Ganzzahl 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 inkompatibel.
VDS_E_IO_ERROR 0x8004242BL	Während des Formats ist ein E/A-Fehler aufgetreten.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Die Medien sind 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 für die Formatierung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h

Weitere Informationen

IVdsDiskPartitionMF2

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS

Freigeben über