IVdsVolumeMF::Format-Methode (vds.h)

[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