IVdsServiceUninstallDisk::UninstallDisks-Methode (vds.h)
[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 |
|---|---|
|
Die Datenträger wurden erfolgreich deinstalliert. |
|
Diese Methode hat einen Warnungs- oder Fehlercode für einen oder mehrere Datenträger zurückgegeben. |
|
Die Datenträger wurden erfolgreich deinstalliert, aber die GUID-Partitionstabellenattribute (GPT) konnten nicht für einen oder mehrere Datenträger abgerufen werden. |
|
BEI VDS ist ein interner Fehler aufgetreten. Prüfen Sie das Ereignisprotokoll, um weitere Informationen zu erhalten. |
|
Mindestens ein Datenträger fehlte. |
|
Der Pfad konnte für einen oder mehrere Datenträger nicht abgerufen werden. |
|
Der Pfad konnte für mindestens ein Volume nicht abgerufen werden. |
|
Mindestens eine der angegebenen VDS-Objekt-IDs entsprechen Datenträgern, die nicht mehr vorhanden sind. |
|
Mindestens eine der angegebenen VDS-Objekt-IDs entsprechen Datenträgern, die nicht vorhanden sind. |
|
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 |