Формат метода класса MSFT_Volume

Форматирует том.

Синтаксис

UInt32 Format(
  [in]  String  FileSystem,
  [in]  String  FileSystemLabel,
  [in]  UInt32  AllocationUnitSize,
  [in]  Boolean Full,
  [in]  Boolean Force,
  [in]  Boolean Compress,
  [in]  Boolean ShortFileNameSupport,
  [in]  Boolean SetIntegrityStreams,
  [in]  Boolean UseLargeFRS,
  [in]  Boolean DisableHeatGathering,
  [out] String  FormattedVolume,
  [out] String  ExtendedStatus
);

Параметры

FileSystem [in]

Файловая система, применяемая к тому. Один из следующих:

  • "ExFAT"
  • "FAT"
  • FAT32
  • "NTFS"
  • ReFS

FileSystemLabel [in]

Метка файловой системы для тома.

AllocationUnitSize [in]

Размер единицы выделения в байтах.

Full [in]

ЗНАЧЕНИЕ TRUE для полного формата или FALSE для быстрого формата.

Force [in]

Значение TRUE для принудительной операции форматирования; в противном случае — ЗНАЧЕНИЕ FALSE.

Сжатие [in]

Значение TRUE для сжатия тома; в противном случае — ЗНАЧЕНИЕ FALSE. Оставьте неопределенным, если fileSystem имеет значение ReFS.

ShortFileNameSupport [in]

ЗНАЧЕНИЕ TRUE , если том должен поддерживать короткие имена; в противном случае — ЗНАЧЕНИЕ FALSE. Оставьте неопределенным, если fileSystem имеет значение ReFS.

SetIntegrity Потоки [in]

Значение TRUE для задания потоков целостности. Оставьте неопределенным, если для файловой системы не задано значение ReFS.

UseLargeFRS [in]

ЗНАЧЕНИЕ TRUE для использования больших FRS; в противном случае — ЗНАЧЕНИЕ FALSE. Оставьте неопределенным, если fileSystem имеет значение ReFS.

DisableHeatGathering [in]

ЗНАЧЕНИЕ TRUE , чтобы отключить сбор тепла; в противном случае — ЗНАЧЕНИЕ FALSE.

FormattedVolume [out]

Получает объект MSFT_Volume, представляющий форматированный том.

ExtendedStatus [out]

Содержит внедренный объект MSFT_служба хранилища ExtendedStatus.

Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.

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

Успех (0)

Не поддерживается (1)

Неопределенная ошибка (2)

Время ожидания (3)

Сбой (4)

Недопустимый параметр (5)

Эта команда не поддерживается в x86, работающей в среде x64. [7]

Доступ запрещен (40001)

Произошла непредвиденная ошибка ввода-вывода (40004)

Указанный объект управляется компонентом отказоустойчивой кластеризации Майкрософт. Диск должен находиться в режиме обслуживания кластера, а состояние ресурса кластера должно быть в сети для выполнения этой операции. (40018)

Операция не разрешена в системной или критической секции. (42010)

Указанный размер кластера недопустим (43000)

Указанная файловая система не поддерживается (43001)

Том не может быть отформатирован быстро (43002)

Число кластеров превышает 32 бита (43003)

Указанная версия UDF не поддерживается (43004)

Размер кластера должен иметь несколько размеров физического сектора диска (43005).

Не удается выполнить запрошенную операцию, если диск доступен только для чтения (43006)

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Пространство имен Root\Microsoft\Windows\служба хранилища
MOF служба хранилища wmi.mof

См. также

MSFT_Volume