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。

Compress [in]

TRUE 表示压缩卷；否则，FALSE。 如果 FileSystem 设置为 ReFS，则保持为未定义。

ShortFileNameSupport [in]

如果卷应支持简短名称，则为 TRUE；否则，FALSE。 如果 FileSystem 设置为 ReFS，则保持为未定义。

SetIntegrityStreams [in]

TRUE 表示设置完整性流。 除非 FileSystem 设置为 ReFS，否则保持为未定义。

UseLargeFRS [in]

TRUE 表示使用大 FRS；否则，FALSE。 如果 FileSystem 设置为 ReFS，则保持为未定义。

DisableHeatGathering [in]

TRUE 表示禁用热收集；否则，FALSE。

FormattedVolume [out]

接收表示已格式化卷的 MSFT_Volume 对象。

ExtendedStatus [out]

包含一个嵌入的 MSFT_StorageExtendedStatus 对象。

此参数允许存储提供程序返回扩展的（特定于实现）错误信息。

返回值

成功 (0)

不支持 (1)

未指定的错误 (2)

超时 (3)

失败 (4)

无效参数 (5)

在 x64 环境中运行的 x86 系统不支持此命令。 (7)

访问被拒 (40001)

发生意外的 I/O 错误 (40004)

指定对象由 Microsoft 故障转移群集组件管理。 执行此操作时，磁盘必须处于群集维护模式，群集资源状态必须为联机。 (40018)

不允许在系统或关键分区上进行此操作。 (42010)

指定的群集大小无效 (43000)

不支持指定的文件系统 (43001)

无法快速格式化卷 (43002)

群集数超过 32 位 (43003)

不支持指定的 UDF 版本 (43004)

群集大小必须是磁盘物理扇区大小的倍数 (43005)

当驱动器为只读时，无法执行请求的操作 (43006)

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
命名空间	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

另请参阅

MSFT_Volume