VDS_DISK_OFFLINE_REASON 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 reasons for a disk to be offline.

Syntax

typedef enum _VDS_DISK_OFFLINE_REASON {
  VDSDiskOfflineReasonNone = 0,
  VDSDiskOfflineReasonPolicy = 1,
  VDSDiskOfflineReasonRedundantPath = 2,
  VDSDiskOfflineReasonSnapshot = 3,
  VDSDiskOfflineReasonCollision = 4,
  VDSDiskOfflineReasonResourceExhaustion = 5,
  VDSDiskOfflineReasonWriteFailure = 6,
  VDSDiskOfflineReasonDIScan = 7,
  VDSDiskOfflineReasonLostDataPersistence = 8
} VDS_DISK_OFFLINE_REASON;

Constants

 
VDSDiskOfflineReasonNone
Value: 0
The reason is unknown.
VDSDiskOfflineReasonPolicy
Value: 1
The disk is offline because of the current SAN policy.
VDSDiskOfflineReasonRedundantPath
Value: 2
The disk is offline because it has a path that is the same as that of another device. This value is used when multipathing is physically enabled, but the MPIO software is not installed or is not functioning properly. (When the MPIO software is functioning properly, it exposes only one disk device.)
VDSDiskOfflineReasonSnapshot
Value: 3
The disk is offline because it contains a volume shadow copy volume. In this case, the disk is a clone of another disk that is online.
VDSDiskOfflineReasonCollision
Value: 4
If the disk is an MBR disk, it is offline because its disk signature is the same as that of another disk that is online. The disk signature is found in the dwSignature member of the VDS_DISK_PROP and VDS_DISK_PROP2 structures and in the Signature member of the DRIVE_LAYOUT_INFORMATION_MBR structure.

If it is a GPT disk, it is offline for one of the following reasons:

  • Its disk identifier is the same as that of another disk that is offline. The disk identifier is found in the DiskGuid member of the VDS_DISK_PROP and VDS_DISK_PROP2 structures and in the DiskId member of the DRIVE_LAYOUT_INFORMATION_GPT structure.

  • One of the partitions has the same partition GUID as another partition on the same disk.
VDSDiskOfflineReasonResourceExhaustion
Value: 5
VDSDiskOfflineReasonWriteFailure
Value: 6
VDSDiskOfflineReasonDIScan
Value: 7
VDSDiskOfflineReasonLostDataPersistence
Value: 8

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header vds.h

See also

VDS_DISK_PROP2