SET_VIRTUAL_DISK_INFO structure (virtdisk.h)
Contains virtual hard disk (VHD) information to use when you call the SetVirtualDiskInformation function to set VHD properties.
Syntax
typedef struct _SET_VIRTUAL_DISK_INFO {
SET_VIRTUAL_DISK_INFO_VERSION Version;
union {
PCWSTR ParentFilePath;
GUID UniqueIdentifier;
struct {
ULONG ChildDepth;
PCWSTR ParentFilePath;
} ParentPathWithDepthInfo;
ULONG VhdPhysicalSectorSize;
GUID VirtualDiskId;
BOOL ChangeTrackingEnabled;
struct {
GUID LinkageId;
PCWSTR ParentFilePath;
} ParentLocator;
};
} SET_VIRTUAL_DISK_INFO, *PSET_VIRTUAL_DISK_INFO;
Members
Version
A SET_VIRTUAL_DISK_INFO_VERSION enumeration that specifies the version of the SET_VIRTUAL_DISK_INFO structure being passed to or from the VHD functions. This determines the type of information set.
ParentFilePath
The path to the parent backing store. Set the Version member to SET_VIRTUAL_DISK_INFO_PARENT_PATH (1).
UniqueIdentifier
The unique identifier of the VHD. Set the Version member to SET_VIRTUAL_DISK_INFO_IDENTIFIER (2).
ParentPathWithDepthInfo
Sets the parent file path and the child depth. Set the Version member to SET_VIRTUAL_DISK_INFO_PARENT_PATH_WITH_DEPTH (3).
Windows 7 and Windows Server 2008 R2: This is not supported before Windows 8 and Windows Server 2012.
ParentPathWithDepthInfo.ChildDepth
Specifies the depth to the child from the leaf. The leaf itself is at depth 1.
ParentPathWithDepthInfo.ParentFilePath
Specifies the depth to the parent from the leaf. The leaf itself is at depth 1.
VhdPhysicalSectorSize
Sets the physical sector size reported by the VHD. Set the Version member to SET_VIRTUAL_DISK_INFO_PHYSICAL_SECTOR_SIZE (4).Windows 7 and Windows Server 2008 R2: This is not supported before Windows 8 and Windows Server 2012.
VirtualDiskId
The identifier that is uniquely created when a user first creates the virtual disk to attempt to uniquely identify that virtual disk. Set the Version member to SET_VIRTUAL_DISK_INFO_VIRTUAL_DISK_ID (5).
Windows 8 and Windows Server 2012: This is not supported before Windows 8.1 and Windows Server 2012 R2.
ChangeTrackingEnabled
Turns resilient change tracking (RCT) on or off for the VHD. TRUE turns RCT on. FALSE turns RCT off. Set the Version member to SET_VIRTUAL_DISK_INFO_CHANGE_TRACKING_STATE (6).
Windows 8.1 and Windows Server 2012 R2: This member is not supported before Windows 10 and Windows Server 2016.
ParentLocator
Sets 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. Set the Version member to SET_VIRTUAL_DISK_INFO_PARENT_LOCATOR (7).
Windows 8.1 and Windows Server 2012 R2: This member is not supported before Windows 10 and Windows Server 2016.
ParentLocator.LinkageId
The unique identifier for the parent linkage information.
ParentLocator.ParentFilePath
The path of the file for the parent VHD.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 |
| Minimum supported server | Windows Server 2008 R2 |
| Header | virtdisk.h |