VDS_DRIVE_STATUS-Enumeration (vdshwprv.h)

Artikel
03/06/2024

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

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 außer 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 seiner RAID-Gruppe oder seinem Speicherpool entfernt. Wenn das Laufwerk beispielsweise aus seiner RAID-Gruppe entfernt wurde, weil es fehlgeschlagen ist, 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 Das Laufwerk ist ausgefallen. 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 diese 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 die aktuelle 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 unbekannte Laufwerk status einem anderen Laufwerk status zuzuordnen.

Hinweis In zukünftigen Windows-Versionen können der VDS_DRIVE_STATUS-Enumeration weitere 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	vdshwprv.h

Weitere Informationen

IVdsDrive::SetStatus

VDS-Enumerationen

VDS_DRIVE_PROP

Freigeben über