Edit

Share via

SET_VIRTUAL_DISK_INFO_VERSION enumeration (virtdisk.h)

  • Article

Contains the version of the virtual disk SET_VIRTUAL_DISK_INFO structure to use in calls to VHD functions. Use the different versions of the structure to set different kinds of information for the VHD.

Syntax

typedef enum _SET_VIRTUAL_DISK_INFO_VERSION {
  SET_VIRTUAL_DISK_INFO_UNSPECIFIED = 0,
  SET_VIRTUAL_DISK_INFO_PARENT_PATH = 1,
  SET_VIRTUAL_DISK_INFO_IDENTIFIER = 2,
  SET_VIRTUAL_DISK_INFO_PARENT_PATH_WITH_DEPTH = 3,
  SET_VIRTUAL_DISK_INFO_PHYSICAL_SECTOR_SIZE = 4,
  SET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID = 5,
  SET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE = 6,
  SET_VIRTUAL_DISK_INFO_PARENT_LOCATOR = 7
} SET_VIRTUAL_DISK_INFO_VERSION;

Constants

 
SET_VIRTUAL_DISK_INFO_UNSPECIFIED
Value: 0
Not used. Will fail the operation.
SET_VIRTUAL_DISK_INFO_PARENT_PATH
Value: 1
Parent information is being set.
SET_VIRTUAL_DISK_INFO_IDENTIFIER
Value: 2
A unique identifier is being set.

Note  If the VHD's unique identifier changes as a result of the
SET_VIRTUAL_DISK_INFO_IDENTIFIER operation, it will break any existing differencing
chains on the VHD.

 
SET_VIRTUAL_DISK_INFO_PARENT_PATH_WITH_DEPTH
Value: 3
Sets the parent file path and the child depth.

Windows 7 and Windows Server 2008 R2:  This value is not supported before Windows 8 and Windows Server 2012.
SET_VIRTUAL_DISK_INFO_PHYSICAL_SECTOR_SIZE
Value: 4
Sets the physical sector size reported by the VHD.

Windows 7 and Windows Server 2008 R2:  This value is not supported before Windows 8 and Windows Server 2012.
SET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID
Value: 5
The identifier that is uniquely created when a user first creates the virtual disk to attempt to uniquely identify that virtual disk.

Windows 8 and Windows Server 2012:  This value is not supported before Windows 8.1 and Windows Server 2012 R2.
SET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE
Value: 6
Whether resilient change tracking (RCT) is turned on for the virtual disk.

Windows 8.1 and Windows Server 2012 R2:  This value is not supported before Windows 10 and Windows Server 2016.
SET_VIRTUAL_DISK_INFO_PARENT_LOCATOR
Value: 7
The parent linkage information that differencing VHDs store. Parent linkage information is metadata used to locate and correctly identify the next parent in the virtual disk chain.

Windows 8.1 and Windows Server 2012 R2:  This value is not supported before Windows 10 and Windows Server 2016.

Requirements

Requirement Value
Minimum supported client Windows 7
Minimum supported server Windows Server 2008 R2
Header virtdisk.h

See also

About VHD

VHD Reference