Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Legt die status eines Controllers auf den angegebenen Wert fest.
Syntax
HRESULT SetStatus(
[in] VDS_CONTROLLER_STATUS status
);
Parameter
[in] status
Werte, die von VDS_CONTROLLER_STATUS aufgezählt werden. Aufrufer können eine Teilmenge der möglichen Enumerationswerte übergeben. Durch übergebene VDS_CS_UNKNOWN wird E_INVALIDARG 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 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 |
|---|---|
|
Dieser Rückgabewert signalisiert ein Software- oder Kommunikationsproblem innerhalb eines Anbieters, der Informationen über das Array zwischenspeichert. Verwenden Sie die IVdsHwProvider::Reenumerate-Methode gefolgt von der IVdsHwProvider::Refresh-Methode , um den Cache wiederherzustellen. |
|
Das Controllerobjekt ist nicht mehr vorhanden. |
|
Der Controller weist einen Fehlerstatus auf und kann den angeforderten Vorgang nicht ausführen. |
|
Ein weiterer Vorgang wird ausgeführt; Dieser Vorgang kann erst fortgesetzt werden, wenn der vorherige Vorgang abgeschlossen ist. |
|
Dieser Vorgang oder eine Kombination von Parametern wird von diesem Anbieter nicht unterstützt. |
Hinweise
Mit dieser Methode können Sie die status eines einzelnen Controllers festlegen. Sie können die status aller Controller in einem Subsystem gleichzeitig festlegen, indem Sie die IVdsSubSystem::SetControllerStatus-Methode aufrufen. Verwenden Sie die IVdsController::GetProperties-Methode, um die aktuelle status des Controllers abzurufen.
Implementierer sind dafür verantwortlich, alle erforderlichen Vorgänge auszuführen, um die status in den angegebenen Zustand zu bringen. Wenn der Aufrufer beispielsweise VDS_CS_OFFLINE als Controller status übergibt, müssen Sie möglicherweise zuerst den Cache für den Controller löschen.
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 | vdshwprv.h |
| Bibliothek | Uuid.lib |