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]

配置單位大小，以位元組為單位。

完整 [in]

若為完整格式，則為TRUE ，或 為 FALSE 表示快速格式。

強制 [in]

TRUE 表示強制格式作業，否則為 FALSE。

壓縮 [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_儲存體 ExtendedStatus 物件。

此參數可讓記憶體提供者傳回擴充的（實作特定）錯誤資訊。

傳回值

成功 （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 [僅限傳統型應用程式]
Namespace	Root\Microsoft\Windows\儲存體
MOF	儲存體 wmi.mof

另請參閱

MSFT_Volume