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。

GptType [in]

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

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)

規格需求

另請參閱

MSFT_Disk