структура CREATE_PARTITION_PARAMETERS (vds.h)

  • Статья

[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Определяет параметры секции для стиля секционирования.

Синтаксис

typedef 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

Параметры для диска с главной загрузочной записью (MBR). Используется, если стильVDS_PST_MBR.

MbrPartInfo.partitionType

Указывает системный тип раздела MBR. Возможные значения:

Значение Значение
PARTITION_ENTRY_UNUSED
0x00
 Неиспользуемая запись.
PARTITION_FAT_12
0x01
 Задает секцию с 12-разрядными записями FAT.
PARTITION_XENIX_1
0x02
 Задает секцию типа XENIX 1.
PARTITION_XENIX_2
0x03
 Задает секцию типа XENIX 2.
PARTITION_FAT_16
0x04
 Указывает секцию с 16-разрядными записями FAT.
PARTITION_EXTENDED
0x05
 Указывает расширенную секцию MS-DOS версии 4.
PARTITION_HUGE
0x06
 Указывает огромный раздел MS-DOS версии 4. Это значение указывает, что в разделе нет файловой системы Майкрософт. Используйте это значение при создании логического тома.
PARTITION_IFS
0x07
 Указывает раздел NTFS или ExFAT.
PARTITION_OS2BOOTMGR
0x0A
 Указывает раздел диспетчера загрузки OS/2, OPUS или когерентного переключения.
PARTITION_FAT32
0x0B
 Указывает раздел FAT32.
PARTITION_FAT32_XINT13
0x0C
 Это значение не поддерживается.
PARTITION_XINT13
0x0E
 Это значение не поддерживается.
PARTITION_XINT13_EXTENDED
0x0F
 Это значение не поддерживается.
PARTITION_PREP
0x41
 Задает раздел эталонной платформы PowerPC.
PARTITION_LDM
0x42
 Указывает раздел диспетчера логических дисков.
PARTITION_UNIX
0x63
 Указывает раздел UNIX.
PARTITION_NTFT
0x80
 Указывает раздел NTFT. Это значение используется в сочетании (то есть побитовое логически ORed) с другими значениями в этой таблице.

MbrPartInfo.bootIndicator

Если задано значение TRUE, раздел активен и может быть загружен; В противном случае секцию нельзя использовать для загрузки системы.

GptPartInfo

Параметры для диска таблицы разделов GUID (GPT). Используется, если стильVDS_PST_GPT.

GptPartInfo.partitionType

Guid типа секции.

Значение Значение
PARTITION_ENTRY_UNUSED_GUID
00000000-0000-0000-0000-000000000000
 Раздел отсутствует.

Этот атрибут можно задать для базовых и динамических дисков.
PARTITION_SYSTEM_GUID
c12a7328-f81f-11d2-ba4b-00a0c93ec93b
 Секция является системной секцией EFI.

Этот атрибут можно задать для базовых и динамических дисков.
PARTITION_MSFT_RESERVED_GUID
e3c9e316-0b5c-4db8-817d-f92df00215ae
 Секция является зарезервированной секцией Майкрософт.

Этот атрибут можно задать для базовых и динамических дисков.
PARTITION_BASIC_DATA_GUID
ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
 Тип секции данных, который создается и распознается Windows.

Только секциям этого типа можно назначать буквы дисков, получать пути GUID тома, папки, подключенные к узлам (также называемые точками подключения тома) и перечисляться вызовами FindFirstVolume и FindNextVolume.

Это значение можно задать только для базовых дисков, за одним исключением. Если и PARTITION_BASIC_DATA_GUID, и GPT_ATTRIBUTE_PLATFORM_REQUIRED заданы для раздела на базовом диске, который впоследствии преобразуется в динамический диск, секция остается базовой, хотя остальная часть диска является динамическим диском. Это связано с тем, что секция считается разделом OEM на диске GPT.
PARTITION_LDM_METADATA_GUID
5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
 Раздел является разделом метаданных диспетчера логических дисков (LDM) на динамическом диске.

Это значение можно задать только для динамических дисков.
PARTITION_LDM_DATA_GUID
af9b60a0-1431-4f62-bc68-3311714a69ad
 Раздел является разделом данных LDM на динамическом диске.

Это значение можно задать только для динамических дисков.
PARTITION_MSFT_RECOVERY_GUID
de94bba4-06d1-4d40-a16a-bfd50179d6ac
 Раздел является разделом восстановления Майкрософт.

Этот атрибут можно задать для базовых и динамических дисков.

GptPartInfo.partitionId

Если идентификатор секции. Если при создании задано значение GUID_NULL (0), будет создано уникальное значение.

GptPartInfo.attributes

Атрибуты секции. Здесь могут содержаться одно или несколько значений из следующего списка:

Значение Значение
GPT_ATTRIBUTE_PLATFORM_REQUIRED
0x0000000000000001
 Если этот атрибут задан, для правильной работы компьютера требуется секция.

Например, этот атрибут должен быть задан для разделов OEM. Обратите внимание, что если этот атрибут задан, можно использовать служебную программу DiskPart.exe для выполнения операций секционирования, таких как удаление секции. Однако поскольку секция не является томом, нельзя использовать служебную программу DiskPart.exe для выполнения операций тома с секцией.

Этот атрибут можно задать для базовых и динамических дисков. Если он задан для раздела на базовом диске и диск преобразуется в динамический диск, раздел остается базовым, даже если остальная часть диска является динамическим диском. Это связано с тем, что секция считается разделом OEM на диске GPT.
GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER
0x8000000000000000
 Если этот атрибут задан, раздел по умолчанию не получает букву диска при перемещении диска на другой компьютер или при первом просмотре диска компьютером.

Этот атрибут полезен в средах сетей хранения данных (SAN).

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.
GPT_BASIC_DATA_ATTRIBUTE_HIDDEN
0x4000000000000000
 Если этот атрибут задан, диспетчер подключения не обнаруживает секцию.

В результате секция не получает букву диска, не получает путь GUID тома, не размещает подключенные папки (также называемые точками подключения тома) и не перечисляется вызовами FindFirstVolume и FindNextVolume. Это гарантирует, что такие приложения, как дефрагментатор диска, не будут обращаться к разделу. Служба теневого копирования томов (VSS) использует этот атрибут.

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.
GPT_BASIC_DATA_ATTRIBUTE_SHADOW_COPY
0x2000000000000000
 Если этот атрибут задан, секция является теневой копией другой секции.

Этот атрибут используется службой теневого копирования томов (VSS). Этот атрибут является указанием для программного обеспечения на основе драйверов фильтра файловой системы (например, антивирусных программ), чтобы избежать присоединения к тому.

Приложение может использовать атрибут для отличия тома теневого копирования от рабочего тома. Например, приложение, выполняющее быстрое восстановление, разрушит теневое копирование LUN путем очистки атрибутов только для чтения и скрытых атрибутов и этого атрибута. Этот атрибут задается при создании теневой копии и очищается при разрыве теневой копии.

Несмотря на свое имя, этот атрибут можно задать для базовых и динамических дисков.

Windows Server 2003: Этот атрибут не поддерживался до Windows Server 2003 с пакетом обновления 1 (SP1).
GPT_BASIC_DATA_ATTRIBUTE_READ_ONLY
0x1000000000000000
 Если этот атрибут задан, секция доступна только для чтения.

Все запросы на запись в секцию завершатся ошибкой.
IOCTL_DISK_IS_WRITABLE завершится сбоем с кодом ошибки Win32 ERROR_WRITE_PROTECT, что приводит к подключению файловой системы как доступной только для чтения, если она присутствует.

VSS использует этот атрибут.

Не устанавливайте этот атрибут для динамических дисков. Установка может привести к ошибкам ввода-вывода и помешать правильному подключению файловой системы.

GptPartInfo.name[36]

Строка Юникода, завершающаяся null, которая указывает имя секции.

Комментарии

Метод IVdsAdvancedDisk::CreatePartition передает эту структуру в качестве аргумента для указания набора параметров.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть vds.h

См. также раздел

IVdsAdvancedDisk::CreatePartition

Структуры VDS

VDS_PARTITION_STYLE