[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]
Defines the partition parameters of a partition style.
Syntaxtypedef struct _CREATE_PARTITION_PARAMETERS {
VDS_PARTITION_STYLE style;
union {
struct {
BYTE partitionType;
BOOLEAN bootIndicator;
} MbrPartInfo;
struct {
GUID partitionType;
GUID partitionId;
ULONGLONG attributes;
WCHAR name[36];
} GptPartInfo;
};
} CREATE_PARTITION_PARAMETERS;
style
MbrPartInfo
Parameters for a Master Boot Record (MBR) disk. Used if style is VDS_PST_MBR.
MbrPartInfo.partitionType
Indicates the system-defined MBR partition type. Possible values are as follows:
Value MeaningMbrPartInfo.bootIndicator
If TRUE, the partition is active and can be booted; otherwise the partition cannot be used to boot the system.
GptPartInfo
Parameters for a GUID Partition Table (GPT) disk. Used if style is VDS_PST_GPT.
GptPartInfo.partitionType
A GUID of the partition type.
Value MeaningThis attribute can be set for basic and dynamic disks.
This attribute can be set for basic and dynamic disks.
This attribute can be set for basic and dynamic disks.
Only partitions of this type can be assigned drive letters, receive volume GUID paths, host mounted folders (also called volume mount points) and be enumerated by calls to FindFirstVolume and FindNextVolume.
This value can be set only for basic disks, with one exception. If both PARTITION_BASIC_DATA_GUID and GPT_ATTRIBUTE_PLATFORM_REQUIRED are set for a partition on a basic disk that is subsequently converted to a dynamic disk, the partition remains a basic partition, even though the rest of the disk is a dynamic disk. This is because the partition is considered to be an OEM partition on a GPT disk.
This value can be set only for dynamic disks.
This value can be set only for dynamic disks.
This attribute can be set for basic and dynamic disks.
GptPartInfo.partitionId
If ID of the partition. If set to GUID_NULL (0) on creation, a unique value will be generated.
GptPartInfo.attributes
Attributes of the partition. This can be one or more of the following values:
Value MeaningFor example, this attribute must be set for OEM partitions. Note that if this attribute is set, you can use the DiskPart.exe utility to perform partition operations such as deleting the partition. However, because the partition is not a volume, you cannot use the DiskPart.exe utility to perform volume operations on the partition.
This attribute can be set for basic and dynamic disks. If it is set for a partition on a basic disk and the disk is converted to a dynamic disk, the partition remains a basic partition, even though the rest of the disk is a dynamic disk. This is because the partition is considered to be an OEM partition on a GPT disk.
This attribute is useful in storage area network (SAN) environments.
Despite its name, this attribute can be set for basic and dynamic disks.
As a result, the partition does not receive a drive letter, does not receive a volume GUID path, does not host mounted folders (also called volume mount points), and is not enumerated by calls to FindFirstVolume and FindNextVolume. This ensures that applications such as Disk Defragmenter do not access the partition. The Volume Shadow Copy Service (VSS) uses this attribute.
Despite its name, this attribute can be set for basic and dynamic disks.
This attribute is used by the Volume Shadow Copy service (VSS). This attribute is an indication for file system filter driver-based software (such as antivirus programs) to avoid attaching to the volume.
An application can use the attribute to differentiate a shadow copy volume from a production volume. For example, an application that performs a fast recovery will break a shadow copy LUN by clearing the read-only and hidden attributes and this attribute. This attribute is set when the shadow copy is created and cleared when the shadow copy is broken.
Despite its name, this attribute can be set for basic and dynamic disks.
Windows Server 2003: This attribute is not supported before Windows Server 2003 with SP1.
All requests to write to the partition will fail.
IOCTL_DISK_IS_WRITABLE will fail with the ERROR_WRITE_PROTECT Win32 error code, which causes the file system to mount as read-only, if a file system is present.
VSS uses this attribute.
Do not set this attribute for dynamic disks. Setting it can cause I/O errors and prevent the file system from mounting properly.
GptPartInfo.name[36]
Null-terminated Unicode string that specifies the name of the partition.
The IVdsAdvancedDisk::CreatePartition method passes this structure as an argument to specify a set of parameters.
Requirements Requirement Value Minimum supported client Windows Vista [desktop apps only] Minimum supported server Windows Server 2003 [desktop apps only] Header vds.h See alsoIVdsAdvancedDisk::CreatePartition
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4