IVdsVolumeMF::Format-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 Dateisystem auf dem aktuellen Volume.

Syntax

HRESULT Format(
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Parameter

[in] type

Ein VDS_FILE_SYSTEM_TYPE Enumerationswert, der das zu verwendende Dateisystem angibt. Muss eine der folgenden Sein: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 oder VDS_FST_UDF.

[in] pwszLabel

Eine Zeichenfolge, die die Dateisystembezeichnung darstellt.

[in] dwUnitAllocationSize

Die Größe der Zuordnungseinheit für das Dateisystem in Bytes, die normalerweise zwischen 512 und 65536 liegt.

[in] bForce

Wenn TRUE, wird das Dateisystem auch während der Verwendung bedingungslos formatiert. andernfalls schlägt der Vorgang fehl.

[in] bQuickFormat

Bei TRUE führt VDS ein Schnellformat aus (nicht jeder Sektor auf dem Volume wird überprüft).

[in] bEnableCompression

Wenn TRUE, ist die Komprimierung für das neu formatierte Dateisystem aktiviert. Die Komprimierung ist ein Feature von NTFS und wird für FAT und FAT32 ignoriert.

[out] ppAsync

Die Adresse eines IVdsAsync-Schnittstellenzeigers , der von VDS bei der Rückgabe initialisiert wird. Aufrufer müssen die Schnittstelle freigeben. Verwenden Sie diesen Zeiger, um den Status des Vorgangs abzubrechen, abzuwarten oder abzufragen.

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 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.

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_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	Beim Format 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 darzustellen.
VDS_E_INVALID_FS_TYPE 0x80042561L	Der Wert des Typparameters wurde nicht VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 oder VDS_FST_UDF.
VDS_E_CANT_INVALIDATE_FVE 0x80042592L	Die BitLocker-Verschlüsselung konnte für das Volume nicht deaktiviert werden.

Bemerkungen

Um ein Startvolume auf einem dynamischen Datenträger zu erstellen, müssen Sie IVdsVolume::SetFlags aufrufen, um das VDS_VF_INSTALLABLE-Flag festzulegen, bevor Sie Format aufrufen, um das Volume zu formatieren.

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 die minimale und maximale 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 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	vds.h
Bibliothek	Uuid.lib

Weitere Informationen

IVdsAsync

IVdsVolumeMF

VDS_FILE_SYSTEM_TYPE

Freigeben über