IVdsVolume::AddPlex-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 ersetzt.]

Fügt dem aktuellen Volume ein Volume als Plex hinzu.

Syntax

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] VolumeId

Die GUID des Volumes, das als Plex hinzugefügt werden soll.

[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
S_OK	Der Plex wurde erfolgreich hinzugefügt.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR 0x80042469L	Das Startvolume auf einem GPT-Datenträger wurde auf einen MBR-Datenträger gespiegelt. Der neue Plex kann nicht zum Starten des Computers verwendet werden.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Auf das Volume kann nicht zugegriffen werden.
VDS_E_VOLUME_NOT_HEALTHY 0x8004243EL	Das Volume schlägt fehl oder ist fehlgeschlagen.
VDS_E_VOLUME_SPANS_DISKS 0x8004243FL	Das Volume umfasst mehrere Datenträger.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE 0x80042440L	Das Volume besteht aus mehreren Erweiterungen.
VDS_E_INVALID_OPERATION 0x80042415L	Das Quellvolume ist kleiner als das Zielvolume. Wenn das Quellvolume größer als das Zielvolume ist, bleibt das Zielvolume gleich groß, und der Vorgang ist erfolgreich.

Hinweise

Dieser Vorgang ist nicht für Basisvolumes gültig, die genau einen Plex aufweisen.

Verwenden Sie diese Methode, um ein Volume als Plex zu einem anderen Volume hinzuzufügen. Beispielsweise kann ein Aufrufer ein Volume (Volume B) erstellen, Volume B als neuen Plex für ein vorhandenes Volume (Volume A) angeben und dann Volume B entfernen. Der neue Plex von Volume A belegt die gleichen Datenträgerausdehnungen wie Volume B.

Hinweis VDS versucht, die gleichen Erweiterungen zu verwenden, kann dieses Verhalten jedoch nicht garantieren.

Anrufer können ein gespiegeltes Volume als neuen Plex zu einem anderen Volume hinzufügen. Das resultierende Volume enthält Plexes, die der Summe der ursprünglichen Volumes entsprechen.

Implementer müssen einen Zeiger auf die IVdsAsync-Schnittstelle für diese Methode zurückgeben, unabhängig davon, ob der Aufruf einen asynchronen Vorgang initiiert.

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

IVdsAsync

IVdsVolume

Volume-Plex-Objekt

Freigeben über