VDS_VOLUME_STATUS Enumeration (vds.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 ersetzt.]

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

Syntax

typedef enum _VDS_VOLUME_STATUS {
  VDS_VS_UNKNOWN = 0,
  VDS_VS_ONLINE = 1,
  VDS_VS_NO_MEDIA = 3,
  VDS_VS_FAILED = 5,
  VDS_VS_OFFLINE = 4
} VDS_VOLUME_STATUS;

Konstanten


`VDS_VS_UNKNOWN` Wert: 0 Die status des Volumes ist unbekannt. Dieser Wert gilt nicht für dynamische Volumes.
`VDS_VS_ONLINE` Wert: 1 Das Volume ist verfügbar.
`VDS_VS_NO_MEDIA` Wert: 3 Bei dem Volume handelt es sich um Wechselmedien, z. B. eine CD-ROM.
`VDS_VS_FAILED` Wert: 5 Das Volume ist nicht verfügbar.
`VDS_VS_OFFLINE` Wert: 4 Das Volume ist offline. Windows Server 2008, Windows Vista und Windows Server 2003: Nicht unterstützt. Wenn das Volume offline ist, wird das VDS_VF_PERMANENTLY_DISMOUNTED-Flag im ulFlags-Element der VDS_VOLUME_PROP - oder VDS_VOLUME_PROP2-Struktur festgelegt.

Hinweise

Wenn die IVdsPack::GetProperties-Methode eine VDS_PACK_PROP-Struktur zurückgibt, deren status Member VDS_PS_OFFLINE ist, legt VDS die status für alle Volumes im Pack auf VDS_VS_FAILED fest. VDS legt die status für bestimmte Volumetypen unter den folgenden Bedingungen auf VDS_VS_FAILED fest:

Für einfache, übergreifende und stripete Volumes – immer dann, wenn ein Datenträger fehlt.
Für gespiegelte Volumes– wenn ein Datenträger mit Ausnahme des letzten Datenträgers fehlt oder Schreibfehler aufweist, die der Plex zu einer getrennten Bedingung übergeht. Ebenso, wenn es sich um den letzten (nicht veralteten) Plex handelt und der Datenträger fehlt.
Für Stripe mit Parität (RAID-5) – wenn der zweite Datenträger fehlt oder wenn eine Spalte getrennt wird (weil der Datenträger fehlt oder die Spalte Schreibfehler aufweist) und ein zweiter Datenträger fehlt.

Die VDS_VOLUME_PROP-Struktur enthält einen VDS_VOLUME_STATUS-Wert als Member, um die status eines Volumes anzugeben.

Hinweis In zukünftigen Windows-Versionen können der VDS_VOLUME_STATUS-Enumeration zusätzliche Konstanten hinzugefügt werden. Aus diesem Grund muss Ihre Anwendung so konzipiert sein, dass sie eine nicht erkannte VDS_VOLUME_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