CREATE_PARTITION_PARAMETERS 結構 (vds.h)
[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。
定義數據分割樣式的數據分割參數。
語法
typedef struct _CREATE_PARTITION_PARAMETERS {
VDS_PARTITION_STYLE style;
union {
struct {
BYTE partitionType;
BOOLEAN bootIndicator;
} MbrPartInfo;
struct {
GUID partitionType;
GUID partitionId;
ULONGLONG attributes;
WCHAR name[36];
} GptPartInfo;
};
} CREATE_PARTITION_PARAMETERS;
成員
style
MbrPartInfo
主要開機記錄 (MBR) 磁碟的參數。 如果樣式VDS_PST_MBR，則會使用 。
MbrPartInfo.partitionType
表示系統定義的 MBR 磁碟分區類型。 可能值如下所示：
MbrPartInfo.bootIndicator
如果 為TRUE，則分割區為使用中且可開機;否則，磁碟分區無法用來開機系統。
GptPartInfo
GUID 資料分割數據表 (GPT) 磁碟的參數。 如果樣式VDS_PST_GPT，則會使用 。
GptPartInfo.partitionType
數據分割類型的 GUID。
| 值 | 意義 |
|---|---|
|
沒有分割區。
這個屬性可以針對基本和動態磁碟進行設定。 |
|
分割區是EFI系統分割區。
這個屬性可以針對基本和動態磁碟進行設定。 |
|
分割區是 Microsoft 保留的數據分割。
這個屬性可以針對基本和動態磁碟進行設定。 |
|
Windows 所建立和辨識的數據分割類型。
只有此類型的分割區可以指派驅動器號、接收磁碟區 GUID 路徑、裝載的資料夾 (也稱為磁碟區裝入點) ，並透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 此值只能針對基本磁碟設定，但有一個例外狀況。 如果PARTITION_BASIC_DATA_GUID和GPT_ATTRIBUTE_PLATFORM_REQUIRED是針對後續轉換成動態磁碟之基本磁碟上的分割區設定，即使磁碟的其餘部分是動態磁碟，分割區仍會維持基本分割區。 這是因為分割區會被視為 GPT 磁碟上的 OEM 磁碟分區。 |
|
分割區是動態磁碟上的邏輯磁碟管理員 (LDM) 元數據分割區。
此值只能針對動態磁碟設定。 |
|
分割區是動態磁碟上的LDM數據分割區。
此值只能針對動態磁碟設定。 |
|
分割區是 Microsoft 復原磁碟分區。
這個屬性可以針對基本和動態磁碟進行設定。 |
GptPartInfo.partitionId
如果分割區的標識碼。 如果設定為建立時GUID_NULL (0) ，將會產生唯一值。
GptPartInfo.attributes
數據分割的屬性。 可為下列一或多個值：
| 值 | 意義 |
|---|---|
|
如果設定這個屬性，計算機需要分割區才能正常運作。
例如，必須針對 OEM 磁碟分區設定這個屬性。 請注意，如果已設定此屬性，您可以使用 DiskPart.exe 公用程式來執行數據分割作業，例如刪除數據分割。 不過，因為分割區不是磁碟區，所以您無法使用 DiskPart.exe 公用程式在分割區上執行磁碟區作業。 這個屬性可以針對基本和動態磁碟進行設定。 如果已針對基本磁碟上的分割區設定，且磁碟會轉換成動態磁碟，即使磁碟的其餘部分是動態磁碟，分割區仍會維持基本分割區。 這是因為分割區會被視為 GPT 磁碟上的 OEM 磁碟分區。 |
|
如果設定這個屬性，當磁碟移至另一部計算機或計算機第一次看到磁碟時，磁碟分區預設不會收到驅動器號。
這個屬性在存放區域網路 (SAN) 環境中很有用。 雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。 |
|
如果已設定這個屬性，掛接管理員不會偵測數據分割。
因此，磁碟分區不會收到驅動器號、未接收磁碟區 GUID 路徑、不會裝載掛接的資料夾 (也稱為磁碟區裝入點) ，而且不會透過呼叫 FindFirstVolume 和 FindNextVolume 來列舉。 這可確保磁碟重組器之類的應用程式不會存取磁碟分區。 磁碟區陰影複製服務 (VSS) 會使用此屬性。 雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。 |
|
如果設定這個屬性，分割區是另一個分割區的陰影複本。
磁碟區陰影複製服務會使用此屬性 (VSS) 。 此屬性表示文件系統篩選驅動程式型軟體 (例如防病毒軟體程式) ，以避免附加至磁碟區。 應用程式可以使用 屬性來區分陰影複製磁碟區與生產磁碟區。 例如，執行快速復原的應用程式會清除只讀和隱藏屬性和此屬性，以中斷陰影複製 LUN。 當陰影複製建立並清除陰影複製中斷時，就會設定這個屬性。 雖然其名稱為 ，但此屬性仍可針對基本和動態磁碟進行設定。 Windows Server 2003： Windows Server 2003 SP1 之前不支援此屬性。 |
|
如果設定這個屬性，則分割區是唯讀的。
寫入數據分割的所有要求都會失敗。 VSS 會使用這個屬性。 請勿為動態磁碟設定此屬性。 設定可能會導致 I/O 錯誤，並防止文件系統正確掛接。 |
GptPartInfo.name[36]
Null 終止的 Unicode 字串，指定數據分割的名稱。
備註
IVdsAdvancedDisk：：CreatePartition 方法會將這個結構當做自變數傳遞，以指定一組參數。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 | vds.h |