Метод IVdsDiskPartitionMF::FormatPartitionEx (vds.h)

Статья
03/08/2023

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

Форматирует существующий раздел OEM, ESP или неизвестный раздел.

Синтаксис

HRESULT FormatPartitionEx(
  [in]  ULONGLONG ullOffset,
  [in]  LPWSTR    pwszFileSystemTypeName,
  [in]  USHORT    usFileSystemRevision,
  [in]  ULONG     ulDesiredUnitAllocationSize,
  [in]  LPWSTR    pwszLabel,
  [in]  BOOL      bForce,
  [in]  BOOL      bQuickFormat,
  [in]  BOOL      bEnableCompression,
  [out] IVdsAsync **ppAsync
);

Параметры

[in] ullOffset

Байтовая смещение секции от начала диска. Это смещение должно быть смещением начала секции.

[in] pwszFileSystemTypeName

Строка Юникода с завершением NULL, содержащая имя файловой системы, с помощью которой нужно отформатировать секцию. Должно иметь значение NULL или одно из следующих значений: "NTFS", "FAT", "FAT32", "UDF" или "EXFAT". Если этот параметр имеет значение NULL, используется значение по умолчанию.

[in] usFileSystemRevision

Редакция файловой системы, если она есть. Этот элемент выражается в виде 16-разрядного двоичного десятичного числа, где между второй и третьей цифрами подразумевается десятичная запятая. Например, значение 0x0250 указывает на редакцию 2.50.

[in] ulDesiredUnitAllocationSize

Размер единицы выделения для файловой системы в байтах. Значение должно иметь значение 2. Если значение равно 0, будет использоваться единица выделения по умолчанию, определяемая типом файловой системы. Диапазон единиц распределения зависит от файловой системы.

[in] pwszLabel

Строка Юникода, завершающаяся null, которая назначается новой файловой системе для тома. Максимальный размер метки зависит от файловой системы.

[in] bForce

Логическое значение, определяющее, является ли формат файловой системы принудительным, независимо от того, используется ли секция.

[in] bQuickFormat

Логическое значение, определяющее, является ли том файловой системы быстро отформатированным. Быстрый формат не проверяет каждый сектор тома.

[in] bEnableCompression

Логическое значение, определяющее, будет ли создана файловая система с включенным сжатием.

Примечание Этот параметр игнорируется, если файловая система не является NTFS.

[out] ppAsync

Указатель на интерфейс IVdsAsync , который после успешного завершения получает интерфейс IVdsAsync для мониторинга и управления этой операцией. Вызывающие абоненты должны освободить полученный интерфейс после завершения работы с ним.

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

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Возвращаемый код или значение	Описание
S_OK	Том успешно секционирован.
VDS_E_BAD_PROVIDER_DATA 0x80042441L	Поставщик вернул недопустимые данные.
VDS_E_DISK_REMOVEABLE 0x8004255AL	Операция не поддерживается на съемных носителях.
VDS_E_FS_NOT_DETERMINED 0x80042593L	Не удалось определить файловую систему по умолчанию.
VDS_E_MISSING_DISK 0x80042454L	Отсутствует диск.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Секция не существует.
VDS_E_PARTITION_NOT_OEM 0x8004256FL	Операция не поддерживается в секциях, не относящихся к OEM.

Кроме того, интерфейс IVdsAsync может возвращать следующие связанные предупреждения и коды ошибок.

Возвращаемый код или значение	Описание
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	Файловая система форматирована, но не сжимается.
VDS_E_ACCESS_DENIED 0x80042427L	Отказано в доступе".
VDS_E_BAD_LABEL 0x80042429L	Метка недопустимая.
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	Том не может быть быстро отформатирован.
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	Количество кластеров слишком велико для представления в виде 32-разрядного целого числа.
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	Размер кластера слишком велик, чтобы разрешить форматирование.
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	Размер кластера слишком мал, чтобы разрешить форматирование.
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	Файловая система несовместима.
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	Носитель несовместим.
VDS_E_IO_ERROR 0x8004242BL	Во время форматирования произошла ошибка ввода-вывода.
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	Носитель защищен от записи.
VDS_E_VOLUME_TOO_BIG 0x8004242DL	Размер тома слишком велик для форматирования.
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	Размер тома слишком мал для форматирования.

Этот метод форматирует только OEM, ESP и неизвестные секции. Для других секций вместо этого необходимо отформатировать соответствующий том с помощью метода IVdsVolumeMF::Format или IVdsVolumeMF2::FormatEx . Обратите внимание, что oem, ESP и неизвестные секции не предоставляются в виде томов и поэтому не могут быть отформатированы с помощью Format или FormatEx.

Этот метод нельзя использовать для форматирования съемных носителей.

Если раздел OEM имеет формат FAT или FAT32, тип секции не изменяется. Если он отформатирован с помощью NTFS, тип секции изменится на PARTITION_IFS (0x07). Сведения о типах секций см. в разделе CREATE_PARTITION_PARAMETERS.

Дополнительные сведения об ограничениях файловой системы, таких как минимальный и максимальный размер единицы распределения (также называемый размером кластера), см. в разделах NtfS Technical Reference и FAT Technical Reference.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

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

IVdsAdvancedDisk::FormatPartition

IVdsDiskPartitionMF

Share via