Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
Das Dateisystem wurde erfolgreich formatiert. |
|
Der Vorgang wird verweigert, wenn der Aufrufer versucht, das System-, Start-, Absturzdump-, Ruhezustands- oder Seitendateivolume zu formatieren. |
|
Das Volume ist fehlgeschlagen. |
|
Auf das Paket, das das Volume enthält, kann nicht zugegriffen werden. Auf alle Volumes in einem Offlinepaket kann nicht zugegriffen werden. |
|
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 |
|---|---|
|
Das Dateisystem ist inkompatibel. |
|
Die Medien sind inkompatibel. |
|
Zugriff verweigert.“ |
|
Die Medien sind schreibgeschützt. |
|
Die Bezeichnung ist ungültig. |
|
Das Volume kann nicht schnell formatiert werden. |
|
Während des Formats ist ein E/A-Fehler aufgetreten. |
|
Die Volumegröße ist zu klein für die Formatierung. |
|
Die Volumegröße ist zu groß für die Formatierung. |
|
Die Clustergröße ist zu klein, um Formatierungen zuzulassen. |
|
Die Clustergröße ist zu groß, um Formatierungen zuzulassen. |
|
Die Anzahl der Cluster ist zu groß, um als 32-Bit-Ganzzahl dargestellt zu werden. |
|
Das Dateisystem ist formatiert, aber nicht komprimiert. |
|
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 |