大网数据广告活动
Hyper-V与虚拟化

Msvm_VirtualHardDiskSettingData class

· 52CE 我爱测

Provides setting data for a virtual hard disk.

Provides setting data for a virtual hard disk.

The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

Syntax

[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
  string   InstanceID;
  string   Caption = "Virtual Hard Disk Setting Data";
  string   Description = "Setting Data for a Virtual Hard Disk";
  string   ElementName;
  uint16   Type;
  uint16   Format;
  string   Path;
  string   ParentPath;
  DATETIME ParentTimestamp;
  string   ParentIdentifier;
  uint64   MaxInternalSize;
  uint32   BlockSize;
  uint32   LogicalSectorSize;
  uint32   PhysicalSectorSize;
  string   VirtualDiskId;
  uint64   DataAlignment;
  uint16   PmemAddressAbstractionType;
  boolean  IsPmemCompatible;
};

Members

The Msvm_VirtualHardDiskSettingData class has these types of members:

Properties

The Msvm_VirtualHardDiskSettingData class has these properties.

BlockSize

Data type: uint32

Access type: Read/write

The block size used by the virtual hard disk, in bytes.

Caption

Data type: string

Access type: Read-only

A short description of the object. This property is inherited from CIM_ManagedElement, and it is always set to "Virtual Hard Disk Setting Data".

DataAlignment

Data type: uint64

Access type: Read/write

Specifies the desired alignment, in bytes, for the data payload of the virtual disk

Note:
Added in Windows 10, version 1709.

Description

Data type: string

Access type: Read-only

A description of the object. This property is inherited from CIM_ManagedElement, and it is always set to "Setting Data for a Virtual Hard Disk".

ElementName

Data type: string

Access type: Read-only

A display name for the object. This property is inherited from CIM_ManagedElement.

Format

Data type: uint16

Access type: Read/write

The format for the virtual hard disk. This will be one of the following values.

VHD (2)

VHDX (3)

VHDSet (4)

Note:
Added in Windows 10 and Windows Server 2016.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

Uniquely identifies an instance of this class. This property is inherited from CIM_SettingData.

IsPmemCompatible

Data type: boolean

Access type: Read/write

Specifies whether the virtual disk can be used as the backing store for a persistent memory device.

Note:
Added in Windows 10, version 1709.

LogicalSectorSize

Data type: uint32

Access type: Read/write

The logical sector size used by the virtual hard disk, in bytes.

MaxInternalSize

Data type: uint64

Access type: Read/write

The maximum size of the virtual hard disk as viewable by the virtual machine, in bytes. This size will be rounded up to the next largest multiple of the sector size.

ParentIdentifier

Data type: string

Access type: Read-only

The GUID used to uniquely identify the parent of the virtual hard disk. If the virtual hard disk does not have a parent, then this field is empty.

Note:
Added in Windows 10 and Windows Server 2016.

ParentPath

Data type: string

Access type: Read/write

The parent of the virtual hard disk. If the virtual hard disk does not have a parent, then this property is empty.

ParentTimestamp

Data type: DATETIME

Access type: Read-only

The timestamp of the parent of the virtual hard disk. If the virtual hard disk does not have a parent, then this field is empty.

Note:
Added in Windows 10 and Windows Server 2016.

Path

Data type: string

Access type: Read/write

The fully qualified path of the virtual hard disk.

PhysicalSectorSize

Data type: uint32

Access type: Read/write

The physical sector size used by the virtual hard disk, in bytes.

PmemAddressAbstractionType

Data type: uint16

Access type: Read/write

The persistent memory address abstraction method to be used with this virtual disk.

Note:
Added in Windows 10, version 1709.

None (0)

BTT (1)

Unknown (65535)

Type

Data type: uint16

Access type: Read/write

The type of virtual hard disk. This will be one of the following values.

Fixed (2)

Dynamic (3)

Differencing (4)

VirtualDiskId

Data type: string

Access type: Read/write

The GUID that is used to uniquely identify the virtual disk.

When the Msvm_ImageManagementService.GetVirtualHardDiskSettingData method returns an instance of Msvm_VirtualHardDiskSettingData, the client can use this property to get the unique disk ID of the VHD.

On conflict detection or otherwise, a client can set the VirtualDiskId value to a new GUID and pass this Msvm_VirtualHardDiskSettingData instance to the Msvm_ImageManagementService.SetVirtualHardDiskSettingData method to change the disk ID of the VHD. If the VHD is not a VHDX VHD, or if the VHD is attached, the operation fails. The operation also fails if the passed value is malformed, that is, not a GUID or has all 0s. The operation silently succeeds if the passed value is the same as the current disk ID.

Errors generated by the SetVirtualDiskInformation function are bubbled up through this property. A client can also use the same mechanism to provide the VirtualDiskId value at VHD creation via the Msvm_ImageManagementService.CreateVirtualHardDisk method in the same namespace. This can be used to create VHD1 or VHD2 VHDs.

Windows 8.1: This value is not supported until Windows 8.1 and Windows Server 2012 R2.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Namespace Root\Virtualization\V2
MOF WindowsVirtualization.V2.mof
DLL Vmms.exe

See also

CIM_SettingData

GetVirtualHardDiskSettingData

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。