IVdsVolumeMF3::OfflineVolume-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.]
Offline schalten Sie das Volume mithilfe des IOCTL_VOLUME_OFFLINE-Steuerelementcodes aus.
Syntax
HRESULT OfflineVolume();
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 | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
Bemerkungen
Wenn das Volume bereits offline ist, gibt die OfflineVolume-Methode S_OK zurück.
Wenn ein Volume offline ist, schlagen alle Lese-, Schreib- und IOCTL-Anforderungen mit ERROR_NOT_READY fehl. Sie können das System- oder Startvolume nicht offline schalten.
Wenn ein Volume online ist, werden alle an das Volume gesendeten Anforderungen berücksichtigt.
Wenn ein Volume, das online ist, nicht bereitgestellt wird, wird es beim nächsten Aufruf zum Öffnen des Volumes eingebunden. Wenn Sie das Volume offline schalten, wird verhindert, dass das nicht bereitgestellte Volume erneut eingebunden wird. Verwenden Sie zum Aufheben der Bereitstellung eines Volumes die IVdsVolumeMF::D ismount-Methode .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |