VDS_VOLUME_STATUS enumeration (vds.h)

  • Article

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Defines the set of object status values for a 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;

Constants

 
VDS_VS_UNKNOWN
Value: 0
The status of the volume is unknown. This value does not apply to dynamic volumes.
VDS_VS_ONLINE
Value: 1
The volume is available.
VDS_VS_NO_MEDIA
Value: 3
The volume is removable media, such as a CD-ROM.
VDS_VS_FAILED
Value: 5
The volume is unavailable.
VDS_VS_OFFLINE
Value: 4
The volume is offline.

Windows Server 2008, Windows Vista and Windows Server 2003:  Not supported. If the volume is offline, the VDS_VF_PERMANENTLY_DISMOUNTED flag is set in the ulFlags member of the VDS_VOLUME_PROP or VDS_VOLUME_PROP2 structure.

Remarks

When the IVdsPack::GetProperties method returns a VDS_PACK_PROP structure whose status member is VDS_PS_OFFLINE, VDS sets the status for all the volumes in the pack to VDS_VS_FAILED. VDS sets the status for specific volume types to VDS_VS_FAILED under the following conditions:

  • For simple, spanned, and striped volumes—whenever a disk is missing.
  • For mirrored volumes—when any disk, except the last disk, is missing or has write errors that the plex transitions to a detached condition. Likewise, if it is the last (non-stale) plex and the disk is missing.
  • For stripe with parity (RAID-5)—when the second disk is missing, or if one column becomes detached (because the disk is missing or the column has write errors), and a second disk is missing.
The VDS_VOLUME_PROP structure includes a VDS_VOLUME_STATUS value as a member to indicate the status of a volume.
Note  Additional constants might be added to the VDS_VOLUME_STATUS enumeration in future Windows versions. For this reason, your application must be designed to gracefully handle an unrecognized VDS_VOLUME_STATUS enumeration constant.
 

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header vds.h

See also

VDS Enumerations

VDS_PACK_PROP

VDS_PACK_STATUS

VDS_VOLUME_PROP