IVdsVolume::RemovePlex-Methode (vds.h)

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

Entfernt ein oder mehrere angegebene Plexes aus dem aktuellen Volume und gibt die Blöcke frei.

Syntax

HRESULT RemovePlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] plexId

Die GUID des zu entfernenden Plexs.

[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 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 Plex wurde erfolgreich entfernt.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Auf das Volume kann nicht zugegriffen werden.
VDS_E_VOLUME_NOT_A_MIRROR 0x80042445L	Das Volume ist kein Spiegel.

Hinweise

Dieser Vorgang kann den letzten Plex eines Volumes nicht entfernen. Verwenden Sie stattdessen die IVdsVolume::D elete-Methode , um das letzte verbleibende Volume (das einzige Plex) zu entfernen. Diese Methode gilt nicht für Basisvolumes, die genau ein Plex aufweisen.

VDS hebt die Bereitstellung des Volumes nicht auf, wenn ein Plex entfernt wird.

Implementierer 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

IVdsVolume::D elete