共用方式為

MSFT_Disk 類別的 CreatePartition 方法

  • 發行項

在磁碟上建立磁碟分區。

語法

UInt32 CreatePartition(
  [in]  UInt64  Size,
  [in]  Boolean UseMaximumSize,
  [in]  UInt64  Offset,
  [in]  UInt32  Alignment,
  [in]  Char16  DriveLetter,
  [in]  Boolean AssignDriveLetter,
  [in]  UInt16  MbrType,
  [in]  String  GptType,
  [in]  Boolean IsHidden,
  [in]  Boolean IsActive,
  [out] String  CreatedPartition,
  [out] String  ExtendedStatus
);

參數

大小 [in]

數據分割所需的大小，以位元組為單位。 這必須等於或小於磁碟 的 LargestFreeExtent 屬性所指定的大小。 此參數不能與 UseMaximumSize搭配使用。

UseMaximumSize [in]

如果 為TRUE，磁碟分區會填滿磁碟上的最大可用範圍。 此參數不能與 Size 參數搭配使用。

位移 [in]

分割區位移，以位元組為單位。 如果未對齊位移，而且未指定 Alignment 參數，則位移會四捨五入或向下捨入至最接近的對齊界限，視建立分割區所在的磁碟大小而定。

對齊 [in]

分割區的對齊方式，以位元組為單位。

DriveLetter [in]

建立時要指派給分割區的驅動器號。 此參數不能與 AssignDriveLetter 搭配使用。 如果同時指定這兩個參數，則會傳回無效的參數錯誤。 如果驅動器號無法使用，將會建立磁碟分區，但會傳回錯誤 『42002』。

AssignDriveLetter [in]

如果 為 TRUE，則會將下一個可用的驅動器號指派給建立的數據分割。 如果沒有其他驅動器號可用，則會建立沒有驅動器號的磁碟分區。 此參數不能與 DriveLetter 搭配使用。 如果同時指定這兩個參數，則會傳回無效的參數錯誤。

MbrType [in]

指定 MBR 資料分割類型。 只有在磁碟的 PartitionStyle 屬性為 MBR 時，才能設定此參數，否則會傳回錯誤。 此參數的預設值為 Huge。

值 意義
FAT12 1 FAT12 檔系統磁碟分區。
FAT16 4 FAT16 檔案系統磁碟分區。
擴充 5 擴充分割區。
大型 6 大型分割區。 這個值表示分割區上沒有 Windows 檔案系統。 建立邏輯磁碟區時，請使用此值。
IFS 7 NTFS 或 ExFAT 磁碟分區。
FAT32 12 FAT32 分割區。

GptType [in]

磁碟分區的 GPT 類型。 只有當磁碟的 PartitionStyle 屬性是 GPT 時，此參數才有效，否則會傳回錯誤。 此參數的預設值為 基本數據。

值 意義
系統分割 區 c12a7328-f81f-11d2-ba4b-00a0c93ec93b EFI 系統分割區。
Microsoft Reserved e3c9e316-0b5c-4db8-817d-f92df00215ae Microsoft 保留的數據分割。
基本數據 ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 基本數據分割。 這是 Windows 所建立和辨識的數據分割類型。 只有此類型的分割區可以指派驅動器號、接收磁碟區 GUID 路徑、裝載的資料夾 (也稱為磁碟區裝入點) ，並透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。
LDM 元數據 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 邏輯磁碟管理員 (LDM) 動態磁碟上的元數據分割區。
LDM Data af9b60a0-1431-4f62-bc68-3311714a69ad 分割區是動態磁碟上的LDM數據分割區。
Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac Microsoft 復原磁碟分區。

IsHidden [in]

如果 為TRUE，分割區將無法接收驅動器號指派，掛接管理員也無法指派磁碟區 GUID 名稱。 FindFirstVolume 和 FindNextVolume 函式將不會列舉數據分割。 分割區可由其相關聯的磁碟區裝置名稱開啟 (，例如 “\\？GLOBALROOT\Device\HarddiskVolumeX“) 。

IsActive [in]

如果 為TRUE，則會設定數據分割的 MBR 作用中位，且分割區會變成可開機。 此參數僅適用於 MBR 磁碟。

CreatedPartition [out]

字串，包含內嵌 MSFT_Partition 物件，代表所建立的數據分割。

ExtendedStatus [out]

包含內嵌 MSFT_StorageExtendedStatus 物件的字串。

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

傳回值

成功 (0)

不支援 (1)

未指定的錯誤 (2)

逾 時 (3)

失敗 (4)

無效的參數 (5)

磁碟正在使用 中 (6)

不支援大小 (4097)

沒有足夠的可用空間 (40000)

拒絕存取 (40001)

沒有足夠的資源來完成作業。 (40002)

快取過期 (40003)

您必須使用 Size 或 UseMaximumSize 參數來指定大小。 您一次只能指定其中一個參數。 (40005)

磁碟尚未初始化。 (41000)

磁碟是唯讀的。 (41002)

磁碟已離線。 (41003)

已達到磁碟的數據分割限制。 (41004)

指定的分割區對齊無效。 它必須是磁碟扇區大小的倍數。 (41005)

參數對這種類型的數據分割無效。 (41006)

指定的分割區類型無效。 (41010)

MBR 磁碟上只能使用前 2 TB。 (41011)

指定的位移無效。 (41012)

裝置中沒有媒體。 (41015)

指定的位移無效。 (41016)

指定的分割區配置無效。 (41017)

指定的物件是由 Microsoft 故障轉移叢集元件所管理。 磁碟必須處於叢集維護模式，且叢集資源狀態必須處於在線狀態，才能執行這項作業。 (41018)

要求的存取路徑已在使用中。 (42002)

無法將存取路徑指派給隱藏的數據分割。 (42004)

存取路徑無效。 (42007)

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
命名空間 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另請參閱

MSFT_Disk