IVdsDiskOnline::Offline-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 den Datenträger aus. Windows Vista: Diese Methode wird erst unter Windows Vista mit Service Pack 1 (SP1) unterstützt. Verwenden Sie stattdessen IVdsDisk2::SetSANMode .

Syntax

HRESULT Offline();

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
VDS_E_FAILED_TO_OFFLINE_DISK	Fehler beim Offlinevorgang.

Hinweise

Wenn ein dynamischer Datenträger lese-/schreibzugriff und online ist, kann er wie folgt schreibgeschützt und offline geschaltet werden:

1. Rufen Sie für jedes Volume auf dem Datenträger die IVdsVolumeMF::D ismount-Methode auf, und legen Sie die Parameter bForce und bPermanent auf TRUE fest.
2. Rufen Sie die Offline-Methode auf.
3. Legen Sie das schreibgeschützte Bit fest. (Dies ist das VDS_DF_READ_ONLY-Flag in der VDS_DISK_PROP-Struktur .)

Wenn ein einfacher Datenträger lese-/schreibzugriff und online ist, kann er schreibgeschützt und auf die gleiche Weise offline geschaltet werden, aber die Reihenfolge der Schritte spielt keine Rolle.

Anforderungen

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

Weitere Informationen

IVdsDiskOnline

IVdsDiskOnline::Online