Метод IVdsAdvancedDisk::FormatPartition (vds.h)

Статья
03/03/2024

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

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

Синтаксис

HRESULT FormatPartition(
  [in]  ULONGLONG            ullOffset,
  [in]  VDS_FILE_SYSTEM_TYPE type,
  [in]  LPWSTR               pwszLabel,
  [in]  DWORD                dwUnitAllocationSize,
  [in]  BOOL                 bForce,
  [in]  BOOL                 bQuickFormat,
  [in]  BOOL                 bEnableCompression,
  [out] IVdsAsync            **ppAsync
);

Параметры

[in] ullOffset

Смещение секции.

[in] type

Значение перечисления VDS_FILE_SYSTEM_TYPE , указывающее используемую файловую систему. Должен иметь одно из следующих значений: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32 или VDS_FST_UDF.

[in] pwszLabel

Строка, представляющая метку тома.

[in] dwUnitAllocationSize

Размер единицы распределения файловой системы в байтах, который обычно находится в диапазоне от 512 до 65536.

[in] bForce

Если значение РАВНО TRUE, секция форматируется даже во время использования; в противном случае операция завершается ошибкой.

[in] bQuickFormat

Если значение РАВНО TRUE, VDS выполняет быстрое форматирование. Быстрый формат не проверяет каждый сектор тома.

[in] bEnableCompression

Если задано значение TRUE, включает сжатие в новой отформатированной файловой системе. Сжатие является функцией NTFS и не может быть задано для файловых систем FAT и FAT32.

[out] ppAsync

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

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

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

Возвращаемый код/значение	Описание
S_OK	Секция успешно отформатирована.
VDS_E_INVALID_OPERATION 0x80042415L	Диск является съемным, или раздел не имеет типа OEM, ESP или неизвестен.
VDS_E_OBJECT_NOT_FOUND 0x80042405L	Секция не существует.

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

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

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

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

Требования

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