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 ersetzt.]
Legt den 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 aufgelistet werden. Aufrufer können eine Teilmenge der möglichen Enumerationswerte übergeben. Das Übergeben von VDS_CS_UNKNOWN gibt E_INVALIDARG zurück.
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 |
|---|---|
|
Dieser Rückgabewert signalisiert ein Software- oder Kommunikationsproblem innerhalb eines Anbieters, der Informationen zum 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 befindet sich in einem fehlerbehafteten Zustand und kann den angeforderten Vorgang nicht ausführen. |
|
Ein weiterer Vorgang wird ausgeführt. Dieser Vorgang kann erst fortgesetzt werden, wenn der vorherige Vorgang oder die vorherigen Vorgänge abgeschlossen sind. |
|
Dieser Vorgang oder diese Kombination von Parametern wird von diesem Anbieter nicht unterstützt. |
Hinweise
Mit dieser Methode können Sie den Status eines einzelnen Controllers festlegen. Sie können den Status aller Controller in einem Subsystem gleichzeitig festlegen, indem Sie die IVdsSubSystem::SetControllerStatus-Methode aufrufen. Verwenden Sie die IVdsController::GetProperties-Methode , um den aktuellen Status des Controllers abzurufen.
Implementierer sind für die Ausführung aller erforderlichen Vorgänge verantwortlich, um den Status in den angegebenen Zustand zu bringen. Wenn der Aufrufer beispielsweise VDS_CS_OFFLINE als Controllerstatus übergibt, müssen Sie möglicherweise zuerst den Cache für den Controller löschen.
Anforderungen
| 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 |