IVdsServiceUninstallDisk::UninstallDisks-Methode (vds.h)

  • Artikel

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

Deinstalliert eine Reihe von Datenträgern.

Syntax

HRESULT UninstallDisks(
  [in]  VDS_OBJECT_ID *pDiskIdArray,
  [in]  ULONG         ulCount,
  [in]  BOOLEAN       bForce,
  [out] BOOLEAN       *pbReboot,
  [out] HRESULT       *pResults
);

Parameter

[in] pDiskIdArray

Adresse eines Puffers, der ein Array von VDS-Objekt-IDs enthält, eine für jeden zu deinstallierenden Datenträger. Jede ID im Array muss eindeutig sein.

[in] ulCount

Anzahl der VDS-Objekt-IDs im Puffer, auf die der pDiskIdArray-Parameter verweist.

[in] bForce

Bei TRUE deinstalliert VDS die Datenträger auch dann, wenn die Volumes nicht gesperrt oder aufgehoben werden können.

[out] pbReboot

Adresse einer BOOLEAN-Variablen , die TRUE empfängt, wenn der Benutzer den Computer neu starten muss, um den Deinstallationsvorgang abzuschließen.

[out] pResults

Die Adresse eines vom Aufrufer zugewiesenen Arrays von HRESULT-Werten . Die Anzahl der Elemente im Array wird vom pDiskIdArray-Parameter angezeigt. Das erste Element dieses Arrays entspricht dem ersten Element im pDiskIdArray usw. Wenn einer der Datenträger nicht ordnungsgemäß initialisiert werden kann, wird der spezifische Fehlercode für den Fehler im entsprechenden Element dieses Arrays zurückgegeben.

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
0
 Die Datenträger wurden erfolgreich deinstalliert.
S_FALSE
1
 Diese Methode hat einen Warnungs- oder Fehlercode für einen oder mehrere Datenträger zurückgegeben.
VDS_S_UNABLE_TO_GET_GPT_ATTRIBUTES
0x0004245BL
 Die Datenträger wurden erfolgreich deinstalliert, aber die GUID-Partitionstabellenattribute (GPT) konnten nicht für einen oder mehrere Datenträger abgerufen werden.
VDS_E_INTERNAL_ERROR
0x80042448L
 BEI VDS ist ein interner Fehler aufgetreten. Prüfen Sie das Ereignisprotokoll, um weitere Informationen zu erhalten.
VDS_E_MISSING_DISK
0x80042454L
 Mindestens ein Datenträger fehlte.
VDS_E_NO_DISK_PATHNAME
0x8004270FL
 Der Pfad konnte für einen oder mehrere Datenträger nicht abgerufen werden.
VDS_E_NO_VOLUME_PATHNAME
0x80042711L
 Der Pfad konnte für mindestens ein Volume nicht abgerufen werden.
VDS_E_OBJECT_DELETED
0x8004240BL
 Mindestens eine der angegebenen VDS-Objekt-IDs entsprechen Datenträgern, die nicht mehr vorhanden sind.
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 Mindestens eine der angegebenen VDS-Objekt-IDs entsprechen Datenträgern, die nicht vorhanden sind.
VDS_E_PROVIDER_CACHE_OUTOFSYNC
0x80042712L
 Der Cache des Anbieters ist nicht mit dem Treibercache synchronisiert.

Hinweise

VDS implementiert diese Methode.

Bei dieser synchronen Methode werden zunächst die Volumes auf den angegebenen Datenträgern deinstalliert und dann die Datenträger deinstalliert. Nachdem die Datenträger deinstalliert wurden, können die entsprechenden LUNs maskiert (ausgeblendet) oder gelöscht werden.

Diese Methode bereinigt die Laufwerkbuchstaben, die den Volumes auf den Datenträgern zugewiesen wurden. Darüber hinaus wird die Volumes offline festgelegt, um zu verhindern, dass ein Volume erneut bereitgestellt wird, nachdem das Demounthandle geschlossen wurde, aber bevor der Datenträger tatsächlich entfernt wird.

Wenn Sie ein dynamisches Volume entfernen, das mehrere Datenträger umfasst, müssen Sie diese Methode aufrufen, anstatt Geräte-Manager-Funktionen zu verwenden.

Anweisungen zum Deinstallieren eines Datenträgers in Windows Server 2003-Releases, in denen die UninstallDisks-Methode nicht unterstützt wird, finden Sie im Abschnitt Hinweise der IVdsLun::SetMask-Methode .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsServiceUninstallDisk