Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

VDS_VOLUME_STATUS enumeration

[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_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

The status of the volume is unknown. This value does not apply to dynamic volumes.

VDS_VS_ONLINE

The volume is available.

VDS_VS_NO_MEDIA

The volume is removable media, such as a CD-ROM.

VDS_VS_FAILED

The volume is unavailable.

VDS_VS_OFFLINE

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

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

 

 

Show: