IVdsVolumeMF3::FormatEx2-Methode (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Formatiert ein Dateisystemvolume auf einer Partition. Diese Methode ist identisch mit der IVdsVolumeMF2::FormatEx-Methode , mit der Ausnahme, dass Formatierungsoptionen mithilfe des Options-Parameters angegeben werden.

Syntax

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

Parameter

[in] pwszFileSystemTypeName

Eine mit NULL endende Unicode-Zeichenfolge, 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. 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 unicode-Zeichenfolge mit NULL-Beendigung, die dem neuen Dateisystem 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 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	Das Volume ist fehlgeschlagen.
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 inkompatibel.
VDS_E_ACCESS_DENIED 0x80042427L	Zugriff verweigert.“
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Die Medien sind 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 für die Formatierung.
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 32-Bit-Ganzzahl 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.

Anforderungen


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
Bibliothek	Uuid.lib

Weitere Informationen

IVdsVolumeMF2::FormatEx

IVdsVolumeMF3

VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG

VDS_FORMAT_OPTION_FLAGS

Freigeben über