MSFT_Partition 類別
表示磁碟上的分割區。
下列語法是從 Managed 物件格式 （MOF） 程式代碼簡化。
語法
class MSFT_Partition : MSFT_StorageObject
{
UInt32 DiskNumber;
UInt32 PartitionNumber;
Char16 DriveLetter;
String AccessPaths[];
UInt16 OperationalStatus;
UInt16 TransitionState;
UInt64 Size;
UInt16 MbrType;
String GptType;
String Guid;
Boolean IsReadOnly;
Boolean IsOffline;
Boolean IsSystem;
Boolean IsBoot;
Boolean IsActive;
Boolean IsHidden;
Boolean IsShadowCopy;
Boolean NoDefaultDriveLetter;
};
成員
MSFT_Partition 類別具有下列類型的成員：
方法
MSFT_Partition 類別具有這些方法。
| 方法 | 描述 |
|---|---|
| AddAccessPath | 將掛接路徑或驅動器號指派新增至磁碟分區。 |
| DeleteObject | 刪除分割區和對應的磁碟區。 |
| GetAccessPaths | 擷取可用來存取分割區的所有裝入點和驅動器號。 |
| GetSupportedSize | 使用 Resize 方法，擷取分割區的最小和最大大小。 |
| 離線 | 卸除相關聯的磁碟區以離線方式讓分割區脫機（如果有的話）。 |
| 線上存取 | 藉由掛接相關聯的磁碟區來讓分割區上線（如果有的話）。 |
| RemoveAccessPath | 從分割區中移除存取路徑。 |
| 調整 | 將分割區和任何相關聯的檔案系統磁碟區大小調整為 Size 參數所指定的大小。 |
| SetAttributes | 設定分割區的各種屬性和屬性。 |
屬性
MSFT_Partition類別具有這些屬性。
AccessPaths
數據類型： 字串 陣列
存取類型：唯讀
字串數位，包含分割區的各種裝入點。 除了掛接的資料夾之外，此清單還包含驅動器號。
DiskNumber
數據類型： UInt32
存取類型：唯讀
限定符： 必要， ModelCorrespondence {“MSFT_Disk.Number”}
包含此磁碟分區之磁碟的操作系統編號。 磁碟號碼不一定會在重新啟動時維持不變。
DriveLetter
數據類型： Char16
存取類型：唯讀
磁碟分區目前指派的驅動器號。 如果未指派驅動器號，則此屬性為 NULL 。
GptType
數據類型： 字串
存取類型：唯讀
數據分割的 GPT 類型。 只有當磁碟的 PartitionStyle 屬性是 GPT ，而且所有其他數據分割樣式都是 NULL 時，這個屬性才有效。
| 值 | 意義 |
|---|---|
| 系統分割 區 c12a7328-f81f-11d2-ba4b-00a0c93ec93b | EFI 系統分割區。 |
| Microsoft保留 e3c9e316-0b5c-4db8-817d-f92df00215ae | Microsoft保留的數據分割。 |
| 基本數據 ebd0a0a2-b9e5-4433-87c0-68b6b72699c7 | 基本數據分割。 這是 Windows 所建立和辨識的數據分割類型。 只有此類型的分割區可以指派驅動器號、接收磁碟區 GUID 路徑、裝載的資料夾（也稱為磁碟區裝入點），並透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 |
| LDM 元數據 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3 | 動態磁碟上的邏輯磁碟管理員 （LDM） 元數據分割區。 |
| LDM 數據 af9b60a0-1431-4f62-bc68-3311714a69ad | 分割區是動態磁碟上的LDM數據分割。 |
| Microsoft Recovery de94bba4-06d1-4d40-a16a-bfd50179d6ac | Microsoft復原分割區。 |
GUID
數據類型： 字串
存取類型：唯讀
分割區的 GPT GUID。 只有當磁碟的 PartitionStyle 屬性是 GPT ，而且所有其他數據分割樣式都是 NULL 時，這個屬性才有效。
IsActive
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，則表示分割區為使用中，而且可用來啟動系統。 只有當磁碟的 PartitionStyle 屬性是 MBR ，而且所有其他數據分割樣式的 NULL 時，這個屬性才有效。
IsBoot
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，則分割區是目前的開機分割區。
IsHidden
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，掛接管理員不會偵測分割區。 因此，分割區不會收到驅動器號、未接收磁碟區 GUID 路徑、未裝載磁碟區裝入點，而且不會透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 這可確保磁碟重組器之類的應用程式不會存取分割區。 磁碟 區陰影複製服務 （VSS） 會在其陰影複製上使用這個屬性。
IsOffline
數據類型： 布爾值
存取類型：唯讀
如果 為 TRUE，則此分割區目前為離線狀態。
IsReadOnly
數據類型： 布爾值
存取類型：唯讀
如果 為 TRUE，則為唯讀分割區。
IsShadowCopy
數據類型： 布爾值
存取類型：唯讀
如果 為 TRUE，則分割區是另一個分割區的陰影複製。 VSS 會使用這個屬性。 此屬性表示文件系統篩選驅動程式型軟體（例如防病毒軟體程式），以避免附加至磁碟區。 應用程式可以使用這個屬性來區分陰影複製分割區與生產數據分割。 例如，執行快速復原的應用程式會清除唯讀和隱藏的屬性和此屬性，以中斷陰影複製虛擬磁碟。 建立陰影複製並在陰影複製中斷時清除時，會設定這個屬性。
IsSystem
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，這是系統分割區。
MbrType
數據類型： UInt16
存取類型：唯讀
分割區的 MBR 類型。 只有當磁碟的 PartitionStyle 屬性是 MBR ，而且所有其他數據分割樣式的 NULL 時，這個屬性才有效。
FAT12 （1）
FAT16 （4）
延長 （5）
巨大的 （6）
IFS （7）
FAT32 （12）
NoDefaultDriveLetter
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，則當探索分割區時，操作系統不會自動指派驅動器號。 這僅適用於 GPT 磁碟，並假設 MBR 磁碟為 FALSE 。 此屬性在儲存局域網路 （SAN） 環境中很有用。
OperationalStatus
數據類型： UInt16
存取類型：唯讀
限定符： 值 （“Unknown”、“Online”、“No Media”、“Failed”、“Offline” ）、 ValueMap （“0”、“1”、“3”、“5”、“4” ）
數據分割的操作狀態。
PartitionNumber
數據類型： UInt32
存取類型：唯讀
限定符： 必要
磁碟分區的作業系統編號。 排序是根據數據分割的位移，相對於其他分割區。 這表示這個屬性的值可能會根據此分割區前面的位移範圍中的分割區組態而變更。
大小
數據類型： UInt64
存取類型：唯讀
分割區的大小總計，以位元組為單位。
TransitionState
數據類型： UInt16
存取類型：唯讀
數據分割的轉換狀態。 下列其中一個值。
| 值 | 意義 |
|---|---|
| 0 | 此值保留給系統使用。 |
| 1 | 數據分割是穩定的。 目前沒有任何設定活動正在進行中。 |
| 2 | 分割區正在擴充。 |
| 3 | 分割區正在壓縮中。 |
| 4 | 分割區正在自動重新設定。 |
| 8 | 正在重新分割分割區。 |
備註
從 Windows 10 開始：MSFT_Partition衍生自 MSFT_StorageObject。
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |