IVdsDisk2::SetSANMode-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Legt den SAN-Modus eines Datenträgers auf offline oder online fest.

Hinweis Ab Windows Vista mit Service Pack 1 (SP1) wird diese Methode durch die Methoden IVdsDiskOnline::Online und IVdsDiskOnline::Offline abgelöst.

 

Syntax

HRESULT SetSANMode(
  [in] BOOL bEnable
);

Parameter

[in] bEnable

Geben Sie TRUE für online oder FALSE für offline an.

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
S_OK	Der SAN-Modus wurde erfolgreich festgelegt.
VDS_E_FAILED_TO_OFFLINE_DISK 0x80042597L	Fehler beim Offlinevorgang.
VDS_E_FAILED_TO_ONLINE_DISK 0x80042596L	Fehler beim Onlinevorgang.

Hinweise

Das Festlegen des SAN-Modus eines Datenträgers auf offline wird als "Offlining" des Datenträgers bezeichnet. Das Festlegen auf "Online" wird als "Onlining" des Datenträgers bezeichnet.

Windows Vista: Wenn Sie den SAN-Modus eines Datenträgers auf offline festlegen, wird der Datenträger ebenfalls schreibgeschützt. Wenn sie auf Online festgelegt wird, wird der Datenträger auch mit Lese-/Schreibzugriff angezeigt.

Anforderungen

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

Weitere Informationen

IVdsDisk2