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 |
|---|---|
|
Der Plex wurde erfolgreich entfernt. |
|
Auf das Volume kann nicht zugegriffen werden. |
|
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 |