MSFT_StoragePool 類別的 GetSupportedSize 方法
擷取可在存放集區中建立的支持虛擬磁碟大小。
這些大小可以透過下列其中一種方式或兩種方式傳回:
- 作為 SupportedSizes 參數中所有支援大小的數位。
- 作為 VirtualDiskSizeMin、 VirtualDiskSizeMax 和 VirtualDiskSizeDivisor 參數所定義的範圍。
語法
UInt32 GetSupportedSize(
[in] String ResiliencySettingName,
[out] UInt64 SupportedSizes[],
[out] UInt64 VirtualDiskSizeMin,
[out] UInt64 VirtualDiskSizeMax,
[out] UInt64 VirtualDiskSizeDivisor,
[out] String ExtendedStatus
);
參數
ResiliencySettingName [in]
判斷支援的大小時,應該使用的復原設定名稱。 請注意,傳回的大小可能會根據復原設定而有所不同。
SupportedSizes [out]
存放集區支援的所有支援大小陣列,以位元組為單位。 如果支援的大小很大,但對於只支持選取的虛擬磁碟大小的存放集區而言,這個參數可以是 NULL 。
VirtualDiskSizeMin [out]
儲存集區中建立之虛擬磁碟的最小虛擬磁碟大小,以位元組為單位。
VirtualDiskSizeMax [out]
儲存集區中建立之虛擬磁碟的最大虛擬磁碟大小,以位元組為單位。
VirtualDiskSizeDivisor [out]
指定決定虛擬磁碟大小時必須使用的乘數。 建立或修改作業中指定的任何大小都必須是此值的倍數。
例如:如果支援的最小大小為 10 GB,且此參數為 2 GB,則此集區支援的大小會是 10 GB、12 GB、14 GB 等等,直到達到支援的大小上限為止。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
快取過期 (40003)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
備註
這個方法傳回的值應該反映存放集區的目前狀態及其可用的儲存容量。 SupportedSizes 中傳回的所有值都必須是 VirtualDiskSizeDivisor 的倍數。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
命名空間 | Root\Microsoft\Windows\Storage |
MOF | Storagewmi.mof |