Метод CreatePartition класса MSFT_Disk

Статья
03/08/2023

Создает раздел на диске.

Синтаксис

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

Параметры

Размер [in]

Требуемый размер (в байтах) для секции. Он должен быть равен или меньше размера, заданного свойством Диску LargestFreeExtent . Этот параметр нельзя использовать с UseMaximumSize.

UseMaximumSize [in]

Если задано значение TRUE, раздел заполняет самый большой свободный экстент на диске. Этот параметр нельзя использовать с параметром Size .

Смещение [в]

Смещение секции в байтах. Если смещение не выравнивается и параметр Выравнивание не указан, смещение округляется вверх или вниз до ближайшей границы выравнивания в зависимости от размера диска, на котором создается секция.

Выравнивание [в]

Выравнивание секции в байтах.

DriveLetter [in]

Буква диска, назначенная секции во время создания. Этот параметр нельзя использовать с AssignDriveLetter. Если указаны оба параметра, будет возвращена ошибка Недопустимый параметр. Если буква диска недоступна, раздел будет создан, но будет возвращена ошибка "42002".

AssignDriveLetter [in]

Если задано значение TRUE, то созданной секции будет назначена следующая доступная буква диска. Если больше нет доступных букв диска, раздел будет создан без буквы диска. Этот параметр нельзя использовать с DriveLetter. Если указаны оба параметра, будет возвращена ошибка Недопустимый параметр.

MbrType [in]

Указывает тип раздела MBR. Этот параметр можно задать, только если свойство PartitionStyle диска имеет значение MBR, в противном случае будет возвращена ошибка. Значение этого параметра по умолчанию — Huge.

Значение	Значение
FAT12 1	Раздел файловой системы FAT12.
FAT16 4	Раздел файловой системы FAT16.
Расширенный 5	Расширенная секция.
Огромный 6	Огромная секция. Это значение указывает, что в разделе нет файловой системы Windows. Используйте это значение при создании логического тома.
IFS 7	Раздел NTFS или ExFAT.
FAT32 12	Раздел FAT32.

GptType [in]

Тип GPT секции. Этот параметр действителен, только если свойство PartitionStyle диска имеет значение GPT, в противном случае будет возвращена ошибка. Значение по умолчанию для этого параметра — Базовые данные.

Значение	Значение
Системная секция c12a7328-f81f-11d2-ba4b-00a0c93ec93b	Системный раздел EFI.
Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae	Раздел, зарезервированный Корпорацией Майкрософт.
Основные данные ebd0a0a2-b9e5-4433-87c0-68b6b72699c7	Базовая секция данных. Это тип секции данных, который создается и распознается Windows. Только секциям этого типа можно назначать буквы дисков, получать пути GUID тома, подключенные к узлам папки (также называемые точками подключения тома) и перечисляться вызовами FindFirstVolume и FindNextVolume.
Метаданные LDM 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3	Раздел метаданных диспетчера логических дисков (LDM) на динамическом диске.
ДАННЫЕ LDM af9b60a0-1431-4f62-bc68-3311714a69ad	Раздел является разделом данных LDM на динамическом диске.
Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac	Раздел восстановления Майкрософт.

IsHidden [in]

Если задано значение TRUE, секция не сможет получить назначение буквы диска, а диспетчер подключений не назначит имя GUID тома. Секция не будет перечисляться функциями FindFirstVolume и FindNextVolume . Раздел можно открыть с помощью связанного с ним имени устройства тома (например, "\\? GLOBALROOT\Device\HarddiskVolumeX").

IsActive [in]

Если задано значение TRUE, будет задан активный бит MBR раздела, и раздел станет загрузочным. Этот параметр действителен только для дисков MBR.

CreatedPartition [out]

Строка, содержащая внедренный объект MSFT_Partition , представляющий созданную секцию.

ExtendedStatus [out]

Строка, содержащая внедренный объект MSFT_StorageExtendedStatus .

Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.

Возвращаемое значение

Успешно (0)

Не поддерживается (1)

Неуказаная ошибка (2)

Время ожидания (3)

Сбой (4)

Недопустимый параметр (5)

Диск используется (6)

Размер не поддерживается (4097)

Недостаточно свободного места (40000)

Доступ запрещен (40001)

Недостаточно ресурсов для завершения операции. (40002)

Кэш устарел (40003)

Размер необходимо указать с помощью параметра Size или UseMaximumSize. Одновременно можно указать только один из этих параметров. (40005)

Диск не инициализирован. (41000)

Диск доступен только для чтения. (41002)

Диск находится в автономном режиме. (41003)

Достигнут предел секционирования диска. (41004)

Указанное выравнивание секции недопустимо. Он должен быть кратным размеру сектора диска. (41005)

Недопустимый параметр для секции этого типа. (41006)

Указанный тип секции недопустим. (41010)

На дисках MBR можно использовать только первые 2 ТБ. (41011)

Указанное смещение недопустимо. (41012)

На устройстве нет носителя. (41015)

Указанное смещение недопустимо. (41016)

Указан недопустимый макет секции. (41017)

Указанный объект управляется компонентом Отказоустойчивая кластеризация Майкрософт. Для выполнения этой операции диск должен находиться в режиме обслуживания кластера, а состояние ресурса кластера должно быть в сети. (41018)

Запрошенный путь доступа уже используется. (42002)

Не удается назначить пути доступа скрытым секциям. (42004)

Недопустимый путь доступа. (42007)

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

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

MSFT_Disk

Поделиться через