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 |