MSFT_StorageSubSystem 類別的 CreateVirtualDisk 方法
建立新的虛擬磁碟。
語法
UInt32 CreateVirtualDisk(
[in] String FriendlyName,
[in] UInt16 Usage,
[in] String OtherUsageDescription,
[in, out] UInt64 Size,
[in] Boolean UseMaximumSize,
[in] UInt16 NumberOfDataCopies,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt64 Interleave,
[in] UInt16 ParityLayout,
[in] Boolean RequestNoSinglePointOfFailure,
[in] Boolean IsEnclosureAware,
[in] UInt16 ProvisioningType,
[in] Boolean RunAsJob,
[out] String CreatedVirtualDisk,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
參數
FriendlyName [in]
虛擬磁碟的易記名稱。
易記名稱必須是描述性名稱，但不需要是唯一的。 請注意，某些儲存子系統不允許在建立虛擬磁碟期間設定易記名稱。 如果子系統不支援此功能，則虛擬磁碟建立應該仍然成功，不過磁碟可能會有不同的名稱指派給它。
這個參數是必要的，而且不能是 NULL。
使用量 [in]
指定虛擬磁碟的預定使用方式。
您可以指定預先定義的描述或自訂描述。 若要指定預先定義的描述， 請使用 Other 以外的值。
若要指定自定義描述，請使用 Other 並指定 OtherUsageDescription 參數的非 NULL 值。
其他 (1)
不受限制 的 (2)
保留給 ComputerSystem (區塊伺服器) (3)
復寫服務 保留 (4)
移轉服務 保留 (5)
本機復本來源 (6)
遠端復本來源 (7)
本機複本目標 (8)
遠端複本目標 (9)
本機復本來源或目標 (10)
遠端復本來源或目標 (11)
差異複本目標 (12)
元素元件 (13)
保留為集區參與者 (14)
複合磁碟區成員 (15)
複合 VirtualDisk 成員 (16)
保留給疏 ( 17)
OtherUsageDescription [in]
新虛擬磁碟的廠商特定使用量。 只有當 Usage 參數設定為 Other 時，才能指定此參數。
大小 [in， out]
虛擬磁碟所需的大小，以位元組為單位。 請注意，某些儲存子系統會將大小向上或向下四捨五入到其配置單位大小的倍數。
只有在 UseMaximumSize 參數為 FALSE 或 NULL 時，儲存子系統才會使用此參數。
如果 UseMaximumSize 參數為 TRUE，則會忽略此參數。
此參數為必要參數，不能為零。
UseMaximumSize [in]
如果為 TRUE，請使用可用的大小上限來建立虛擬磁碟。
這個參數不能與 Size 參數一起使用。
NumberOfDataCopies [in]
要為此虛擬磁碟維護的完整數據復本數目。
PhysicalDiskRedundancy [in]
虛擬磁碟在數據遺失之前應該能夠承受的實體磁碟失敗數目。
NumberOfColumns [in]
應分割數據的基礎實體磁碟數目。 此為必要參數。
交錯 [in]
在一般等量型復原設定中，應該為等量分割的位元元組數目。 等量區定義為位於一個實體磁碟上等量區部分的大小。 因此 Interleave * NumberOfColumns 會產生一個等量的大小。 此為必要參數。
ParityLayout [in]
如果需要同位型復原設定，請將此參數設定為下列其中一個值。
如果所需的復原設定不是同位型，此屬性必須是 NULL。
非旋轉同位 (1)
旋轉同位 (2)
RequestNoSinglePointOfFailure [in]
設定為 TRUE 以要求沒有單一失敗點。
IsEnclosureAware [in]
此虛擬磁碟的配置行為。 機箱感知虛擬磁碟會以智慧方式挑選要用於其備援的實體磁碟。 如果 為 TRUE，虛擬磁碟會嘗試使用不同的機箱中的實體磁碟，以平衡兩個或多個實體機箱之間的容錯。
ProvisioningType [in]
虛擬磁碟的布建類型。
細 (1)
已修正 (2)
RunAsJob [in]
如果 為 TRUE，這個方法會在要求需要很長的時間才能服務時使用 CreatedStorageJob 參數。 如果已建立記憶體作業來追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。
注意
即使 RunAsJob 為 TRUE，此方法仍可在有足夠的時間完成時傳回結果。
如果 為 FALSE 或 NULL，這個方法會遵循預設 WMI 異步行為，如用戶端的叫用方法所決定。 換句話說，除非另有要求，否則它是同步的。
CreatedVirtualDisk [out]
如果已成功建立虛擬磁碟，此參數會收到包含內嵌 MSFT_VirtualDisk 物件的字串。
CreatedStorageJob [out]
如果 RunAsJob 設定為 TRUE ，而且這個方法需要很長的時間才能執行，則此參數會收到用來追蹤長時間執行作業之記憶體作業對象的參考。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
已檢查方法參數 - 作業啟動 (4096)
不支援大小 (4097)
沒有足夠的可用空間 (40000)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
快取過期 (40003)
您必須使用 Size 或 UseMaximumSize 參數來指定大小。 您一次只能指定其中一個參數。 (40005)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
找不到可支援此虛擬磁碟設定的存放集區。 (47000)
不支援 NoSinglePointOfFailure 的值。 (49001)
PhysicalDiskRedundancy 的值超出支援的值範圍。 (49002)
NumberOfDataCopies 的值超出支援的值範圍。 (49003)
ParityLayout 的值超出支援的值範圍。 (49004)
Interleave 的值超出支援的值範圍。 (49005)
NumberOfColumns 的值超出支援的值範圍。 (49006)
備註
當下列其中一項成立時，通常會使用此方法：
- 儲存子系統的存放集區不允許直接建立虛擬磁碟。
- 儲存子系統不支援存放集區。
記憶體管理提供者也可以選擇實作這個方法，以「智慧方式」為使用者挑選存放集區。 如果支援這個方法，子系統的 SupportsAutomaticStoragePoolSelection 屬性應該設定為 TRUE。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |