VDS_DRIVE_STATUS-Enumeration (vds.h)

  • Artikel

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

Definiert den Satz von Objekt-status-Werten für ein Laufwerk.

Syntax

typedef enum _VDS_DRIVE_STATUS {
  VDS_DRS_UNKNOWN = 0,
  VDS_DRS_ONLINE = 1,
  VDS_DRS_NOT_READY = 2,
  VDS_DRS_OFFLINE = 4,
  VDS_DRS_FAILED = 5,
  VDS_DRS_REMOVED = 8
} VDS_DRIVE_STATUS, *PVDS_DRIVE_STATUS;

Konstanten

 
VDS_DRS_UNKNOWN
Wert: 0
Die status des Laufwerks kann nicht bestimmt werden.
VDS_DRS_ONLINE
Wert: 1
Das Laufwerk ist verfügbar und wird verwendet. Der diesem Laufwerk status zugeordnete VDS_HEALTH Wert kann ein beliebiger Wert mit Ausnahme VDS_H_FAILED sein.
VDS_DRS_NOT_READY
Wert: 2
Das Laufwerk ist ausgelastet. Der VDS_HEALTH-Wert kann ein beliebiger Wert mit Ausnahme VDS_H_FAILED sein.
VDS_DRS_OFFLINE
Wert: 4
Das Laufwerk ist physisch vorhanden, wurde aber aus der RAID-Gruppe oder dem Speicherpool entfernt. Wenn das Laufwerk beispielsweise aufgrund eines Fehlers aus der RAID-Gruppe entfernt wurde, sollte das Laufwerk status VDS_DRS_FAILED werden. Wenn das Laufwerk im Rahmen des Speicherausgleichs entfernt wurde, sollte das Laufwerk status VDS_DRS_OFFLINE werden.

Wenn dieses Laufwerk status festgelegt ist, wird eine VDS_NF_DRIVE_REMOVED Benachrichtigung gesendet.

Der VDS_HEALTH Wert kann ein beliebiger Wert sein.
VDS_DRS_FAILED
Wert: 5
Beim Laufwerk ist ein Fehler aufgetreten. Der VDS_HEALTH Wert sollte VDS_H_FAILED oder VDS_H_FAILING sein.
VDS_DRS_REMOVED
Wert: 8
Das Laufwerk wurde physisch vom Subsystem getrennt. Wenn dieser status festgelegt ist, wird eine VDS_NF_DRIVE_DEPART Benachrichtigung gesendet.

Windows Server 2008, Windows Vista und Windows Server 2003: Dieser Wert wird nicht unterstützt.

Hinweise

Die IVdsDrive::SetStatus-Methode übergibt einen VDS_DRIVE_STATUS Wert als Argument, um die status eines Laufwerks festzulegen, und die VDS_DRIVE_PROP-Struktur enthält einen VDS_DRIVE_STATUS-Wert als Member, um den aktuellen status anzugeben.

Wenn Ihre Anwendung auf einen VDS_DRIVE_STATUS Wert stößt, den sie nicht erkennt, sollte das Laufwerk status als unbekannt angezeigt werden. Es sollte nicht versucht werden, das nicht erkannte Laufwerk status einem anderen Laufwerk status zuzuordnen.

Hinweis In zukünftigen Windows-Versionen können der VDS_DRIVE_STATUS-Enumeration zusätzliche Konstanten hinzugefügt werden. Aus diesem Grund muss Ihre Anwendung so konzipiert sein, dass sie eine nicht erkannte VDS_DRIVE_STATUS Enumerationskonstante ordnungsgemäß verarbeitet.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile vds.h

Weitere Informationen

IVdsDrive::SetStatus

VDS-Enumerationen

VDS_DRIVE_PROP