Метод IVdsAdvancedDisk::FormatPartition (vds.h)
[Начиная с 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 . Возможные возвращаемые значения включают следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Секция успешно отформатирована. |
|
Диск является съемным, или раздел не имеет типа OEM, ESP или неизвестен. |
|
Секция не существует. |
Комментарии
VDS реализует этот метод.
Этот метод форматирует только 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 |