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 durch die Windows Storage Management-API abgelöst.]
Formatiert eine vorhandene OEM-, ESP- oder unbekannte Partition. Diese Methode ist identisch mit der IVdsDiskPartitionMF::FormatPartition-Methode , mit der Ausnahme, dass Formatierungsoptionen mithilfe des Options-Parameters angegeben werden.
Syntax
HRESULT FormatPartitionEx2(
[in] ULONGLONG ullOffset,
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] DWORD Options,
[out] IVdsAsync **ppAsync
);
Parameter
[in] ullOffset
Der Byteoffset der Partition vom Anfang des Datenträgers. Dieser Offset muss der Offset des Anfangs einer Partition sein.
[in] pwszFileSystemTypeName
Eine MIT NULL beendete Unicode-Zeichenfolge, die den Namen des Dateisystems enthält, mit dem die Partition formatiert werden soll. Muss NULL oder eine der folgenden Werte sein: "NTFS", "FAT", "FAT32", "UDF" oder "EXFAT". Wenn dieser Parameter NULL ist, wird ein Standardwert 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 MIT NULL beendete Unicode-Zeichenfolge, die die Bezeichnung enthält, die dem neuen Dateisystem für die Partition 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 Volume wurde erfolgreich partitioniert. |
|
Ein Anbieter hat fehlerhafte Daten zurückgegeben. |
|
Der Vorgang wird auf Wechselmedien nicht unterstützt. |
|
Das Standarddateisystem konnte nicht bestimmt werden. |
|
Der Datenträger fehlt. |
|
Die Partition ist nicht vorhanden. |
|
Der Vorgang wird für Nicht-OEM-Partitionen nicht unterstützt. |
Darüber hinaus kann die IVdsAsync-Schnittstelle die folgenden zugehörigen Warnungen und Fehlercodes zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Das Dateisystem ist formatiert, aber nicht komprimiert. |
|
Zugriff verweigert.“ |
|
Die Bezeichnung ist ungültig. |
|
Das Volume kann nicht schnell formatiert werden. |
|
Die Anzahl der Cluster ist zu groß, um als 32-Bit-Ganzzahl dargestellt zu werden. |
|
Die Clustergröße ist zu groß, um Formatierungen zuzulassen. |
|
Die Clustergröße ist zu klein, um Formatierungen zuzulassen. |
|
Das Dateisystem ist inkompatibel. |
|
Die Medien sind inkompatibel. |
|
Während des Formats ist ein E/A-Fehler aufgetreten. |
|
Die Medien sind schreibgeschützt. |
|
Die Volumegröße ist zu groß für die Formatierung. |
|
Die Volumegröße ist zu klein für die Formatierung. |
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |