Метод IVdsVolumeMF3::FormatEx2 (vds.h)
[Начиная с Windows 8 и Windows Server 2012, COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Форматирует том файловой системы в секции. Этот метод идентичен методу IVdsVolumeMF2::FormatEx , за исключением того, что параметры форматирования задаются с помощью параметра Options .
Синтаксис
HRESULT FormatEx2(
[in] LPWSTR pwszFileSystemTypeName,
[in] USHORT usFileSystemRevision,
[in] ULONG ulDesiredUnitAllocationSize,
[in] LPWSTR pwszLabel,
[in] DWORD Options,
[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] Options
Битовая маска значений перечисления VDS_FORMAT_OPTION_FLAGS , определяющих параметры форматирования.
[out] ppAsync
Указатель на интерфейс IVdsAsync , который после успешного завершения получает интерфейс IVdsAsync для мониторинга и управления этой операцией. Вызывающие стороны должны освободить полученный интерфейс после завершения работы с ним.
Возвращаемое значение
Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать коды преобразованных системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.
| Возвращаемый код/значение | Описание |
|---|---|
|
Файловая система успешно отформатирована. |
|
Операция отклоняется, если вызывающий объект пытается отформатировать том системы, загрузки, аварийного завершения, гибернации или файла подкачки. |
|
Сбой тома. |
|
Пакет, содержащий том, недоступен. Все тома в автономном пакете недоступны. |
|
Не удалось определить файловую систему по умолчанию. |
Кроме того, интерфейс IVdsAsync может возвращать следующие связанные предупреждения и коды ошибок.
| Возвращаемый код/значение | Описание |
|---|---|
|
Файловая система несовместима. |
|
Носитель несовместим. |
|
Отказано в доступе". |
|
Носитель защищен от записи. |
|
Недопустимая метка. |
|
Том не может быть отформатирован в быстром формате. |
|
Во время форматирования произошла ошибка ввода-вывода. |
|
Размер тома слишком мал для форматирования. |
|
Размер тома слишком велик для форматирования. |
|
Размер кластера слишком мал, чтобы разрешить форматирование. |
|
Размер кластера слишком велик, чтобы разрешить форматирование. |
|
Количество кластеров слишком велико для представления в виде 32-разрядного целого числа. |
|
Файловая система форматирована, но не сжимается. |
|
Не удалось отключить шифрование BitLocker для тома. |
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vds.h |
| Библиотека | Uuid.lib |