IVdsAdvancedDisk::CreatePartition-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Erstellt eine Partition auf einem Basisdatenträger.
Die IVdsCreatePartitionEx::CreatePartitionEx-Methode ersetzt diese Methode.
Syntax
HRESULT CreatePartition(
[in] ULONGLONG ullOffset,
[in] ULONGLONG ullSize,
[in] CREATE_PARTITION_PARAMETERS *para,
[out] IVdsAsync **ppAsync
);
Parameter
[in] ullOffset
Der Partitionsoffset.
[in] ullSize
Die Größe der neuen Partition in Bytes.
[in] para
Der Zeiger auf Parameter, die von der CREATE_PARTITION_PARAMETERS-Struktur definiert 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, darauf zu warten oder den Status des Vorgangs 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 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 |
|---|---|
|
Die Partition wurde erfolgreich erstellt. |
|
Ein Wechseldatenträger enthält keine Medien. |
|
Die Medien unterstützen diesen Vorgang nicht. Der Aufrufer kann beispielsweise keine Partition auf einer CD-ROM erstellen. |
|
Das Erstellen einer zweiten Partition auf Wechselmedien wird nicht unterstützt. Alternativ gibt dieser Fehler an, dass der Datenträger ein dynamischer Datenträger ist. |
|
Die maximale Anzahl von Partitionen (vier primäre oder drei primäre und eine erweiterte Partition) ist bereits vorhanden, wenn der Aufrufer versucht, eine zusätzliche primäre Partition oder erweiterte Partition zu erstellen. |
|
Die Partition wurde erfolgreich erstellt, aber VDS konnte die Startoptionen im BCD-Speicher (Boot Configuration Data) nicht aktualisieren.
Windows Server 2003: Startoptionen werden in der boot.ini-Datei auf einem x86- oder x64-System oder NVRAM auf einem Itanium-System gespeichert. |
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 |