IVdsAdvancedDisk::FormatPartition-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 eine vorhandene OEM-, ESP- oder unbekannte Partition.
Syntax
HRESULT FormatPartition(
[in] ULONGLONG ullOffset,
[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] ullOffset
Der Partitionsoffset.
[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 Volumebezeichnung 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 die Partition auch während der Verwendung formatiert. andernfalls schlägt der Vorgang fehl.
[in] bQuickFormat
Wenn TRUE, führt VDS ein Schnellformat aus. Ein Schnellformat überprüft nicht jeden Sektor auf dem Volume.
[in] bEnableCompression
Wenn TRUE, aktiviert die Komprimierung für das neu formatierte Dateisystem. Die Komprimierung ist ein Ntfs-Feature und kann nicht für FAT- und FAT32-Dateisysteme festgelegt werden.
[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 |
|---|---|
|
Die Partition wurde erfolgreich formatiert. |
|
Der Datenträger ist wechselbar, oder die Partition ist nicht vom Typ OEM, ESP oder unbekannt. |
|
Die Partition ist nicht vorhanden. |
Hinweise
VDS implementiert diese Methode.
Diese Methode formatiert nur OEM-, ESP- und unbekannte Partitionen. Für andere Partitionen müssen Sie stattdessen das entsprechende Volume mithilfe 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.
Informationen zu Dateisystemgrenzwerten, z. B. minimale und maximale Größe der Zuordnungseinheiten (auch als Clustergröße bezeichnet), finden Sie unter TECHNISCHE REFERENZ ZU NTFS und FAT Technical Reference.
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |