Метод IVdsVolumeMF2::FormatEx (vds.h)
[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Форматирует том файловой системы в секции.
Синтаксис
HRESULT FormatEx(
[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] pwszFileSystemTypeName
Строка Юникода, завершающаяся null, содержащая имя файловой системы, с помощью которой нужно отформатировать том. Этот параметр может иметь значение NULL или имя файловой системы Windows. Поддерживаются следующие файловые системы: NTFS, FAT, FAT32, UDF и EXFAT. Если этот параметр имеет значение NULL, используется файловая система по умолчанию. Дополнительные сведения см. в разделе VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG.
[in] usFileSystemRevision
Редакция файловой системы, если она есть. Этот элемент выражается в виде 16-разрядного двоичного десятичного числа, где десятичная запятая подразумевается между второй и третьей цифрами. Например, значение 0x0250 указывает редакцию 2.50.
[in] ulDesiredUnitAllocationSize
Размер единицы распределения для файловой системы в байтах. Значение должно быть степенью 2. Если значение равно 0, будет использоваться единица распределения по умолчанию, определяемая типом файловой системы. Диапазон единиц распределения зависит от файловой системы.
[in] pwszLabel
Строка Юникода, завершающаяся null, для назначения новой файловой системе. Максимальный размер метки зависит от файловой системы.
[in] bForce
Логическое значение, определяющее, является ли формат файловой системы принудительным, независимо от того, используется ли секция.
[in] bQuickFormat
Логическое значение, определяющее, является ли том файловой системы быстро отформатированным. Быстрый формат не проверяет каждый сектор тома.
[in] bEnableCompression
Логическое значение, определяющее, будет ли создан том файловой системы с включенным сжатием.
[out] ppAsync
Указатель на интерфейс IVdsAsync , который после успешного завершения получает интерфейс IVdsAsync для мониторинга и управления этой операцией. Вызывающие стороны должны освободить полученный интерфейс после завершения работы с ним.
Возвращаемое значение
Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Файловая система успешно отформатирована. |
|
Операция отклоняется, если вызывающий объект пытается отформатировать том системы, загрузки, аварийного завершения, гибернации или файла подкачки. |
|
Сбой тома. |
|
Пакет, содержащий том, недоступен. Все тома в автономном пакете недоступны. |
|
Не удалось определить файловую систему по умолчанию. |
Кроме того, интерфейс IVdsAsync может возвращать следующие связанные предупреждения и коды ошибок:
| Возвращаемый код/значение | Описание |
|---|---|
|
Файловая система несовместима. |
|
Носитель несовместим. |
|
Отказано в доступе". |
|
Носитель защищен от записи. |
|
Недопустимая метка. |
|
Том не может быть отформатирован в быстром формате. |
|
Во время форматирования произошла ошибка ввода-вывода. |
|
Размер тома слишком мал для форматирования. |
|
Размер тома слишком велик для форматирования. |
|
Размер кластера слишком мал, чтобы разрешить форматирование. |
|
Размер кластера слишком велик, чтобы разрешить форматирование. |
|
Количество кластеров слишком велико для представления в виде 32-разрядного целого числа. |
|
Файловая система форматирована, но не сжимается. |
|
Не удалось отключить шифрование BitLocker для тома. |
Комментарии
Если раздел OEM имеет формат FAT или FAT32, тип секции не изменяется. Если он отформатирован с помощью NTFS, тип секции изменяется на PARTITION_IFS (0x07). Сведения о типах секций см. в разделе CREATE_PARTITION_PARAMETERS.
Если этот метод вызывается для тома, защищенного шифрованием полного тома BitLocker, шифрование BitLocker отключается для тома до тех пор, пока пользователь повторно не включит его.
Дополнительные сведения об ограничениях файловой системы, таких как минимальный и максимальный размер единицы распределения (также называемый размером кластера), см. в разделах NtfS Technical Reference и FAT Technical Reference.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vds.h |
| Библиотека | Uuid.lib |