IVdsPack::AddDisk-Methode (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Fügt einem Onlinepaket einen Datenträger hinzu.

Syntax

HRESULT AddDisk(
  [in] VDS_OBJECT_ID       DiskId,
  [in] VDS_PARTITION_STYLE PartitionStyle,
  [in] BOOL                bAsHotSpare
);

Parameter

[in] DiskId

Die GUID des Datenträgers.

[in] PartitionStyle

Der Stil kann MBR oder GPT sein. Weitere Informationen finden Sie unter VDS_PARTITION_STYLE-Enumeration .

[in] bAsHotSpare

Wenn true, kann VDS den Datenträger als Hot Spare verwenden. Andernfalls kann der Datenträger nicht für diesen Vorgang verwendet werden. Nur Hardwareanbieter unterstützen hot sparing.

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
S_OK	Der Datenträger wurde erfolgreich hinzugefügt.
VDS_E_NOT_AN_UNALLOCATED_DISK 0x80042418L	Der Datenträger ist unformatiert.
VDS_E_OPERATION_DENIED 0x8004240AL	Der hinzuzufügende Datenträger wird bereinigt.
VDS_E_PROVIDER_FAILURE 0x80042442L	Während des Vorgangs tritt ein Anbieterfehler auf.
VDS_E_NOT_SUPPORTED 0x80042400L	Das Hinzufügen eines zweiten Datenträgers zu einem Basispaket wird nicht unterstützt.
VDS_E_PACK_OFFLINE 0x80042444L	Auf das Zielpaket kann nicht zugegriffen werden.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Der Datenträger wurde nicht gefunden.
VDS_E_DMADMIN_METHOD_CALL_FAILED 0x80042420L	Der LDM-Dienst (Logical Disk Manager) konnte eine Methode nicht abschließen.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Der dynamische Anbietercache ist beschädigt.

Hinweise

VDS implementiert diese Methode.

Diese Methode initialisiert einen Rohdatenträger (einen Datenträger, für den keine Partitionierung definiert ist) und fügt ihn dem Paket hinzu. Bevor diese Methode aufgerufen wird, befindet sich der Rohdatenträger im Besitz des VDS-Diensts. Nachdem diese Methode zurückgegeben wurde, befindet sich der Datenträger im Besitz des Basisanbieters.

Verwenden Sie die IVdsAdvancedDisk::Clean-Methode , um die Auswirkungen dieser Methode rückgängig zu machen, d. h. um das Partitionierungsformat zu entfernen und zu bewirken, dass der Datenträger ein Rohdatenträger ist, der sich im Besitz des VDS-Diensts befindet.

Sie können AddDisk nicht verwenden, um die Partitionierung auf einem vorhandenen Datenträger neu zu definieren.

Wenn Sie einem Basispaket einen GPT-Datenträger hinzufügen, erstellt der Vorgang automatisch eine MSR-Partition auf dem Datenträger. Geräte, auf denen das WinPE-Betriebssystem ausgeführt wird, sind die Ausnahme, da ein Administrator es vorzieht, eine ESP-Partition auf dem Datenträger zu erstellen. Die ESP-Partition muss, sofern vorhanden, die erste Partition auf dem Datenträger sein.

Wenn Sie den Datenträger einem dynamischen Paket hinzufügen, erstellt der Vorgang keine MSR-Partition.

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

Weitere Informationen

IVdsPack

VDS_PACK_PROP

VDS_PARTITION_STYLE

Freigeben über