MSFT_VirtualDisk 類別的 Resize 方法
調整虛擬磁碟的大小。
語法
UInt32 Resize(
[in, out] UInt64 Size,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
參數
大小 [in, out]
在輸入時,此參數是虛擬磁碟所要求的新大小,以位元組為單位。
在輸出中,此參數會在重設大小作業之後收到實際的新虛擬磁碟大小。
此為必要參數。
RunAsJob [in]
如果 為 TRUE,這個方法會在要求需要很長的時間才能服務時使用 CreatedStorageJob 參數。 如果已建立記憶體作業來追蹤作業,這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。
注意
即使 RunAsJob 為 TRUE,此方法仍可在有足夠的時間完成時傳回結果。
如果 為 FALSE 或 NULL,這個方法會遵循預設 WMI 異步行為,如用戶端的叫用方法所決定。 換句話說,除非另有要求,否則它是同步的。
CreatedStorageJob [out]
如果 RunAsJob 設定為 TRUE ,而且這個方法需要很長的時間才能執行,則此參數會收到用來追蹤長時間執行作業之記憶體作業對象的參考。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
已檢查方法參數 - 作業啟動 (4096)
不支援大小 (4097)
沒有足夠的可用空間 (40000)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
儲存集區無法完成作業,因為其健全狀況或作業狀態不允許。 (48006)
儲存集區無法完成作業,因為其設定是唯讀的。 (48007)
虛擬磁碟無法完成作業,因為另一部計算機會控制其設定。 (50002)
虛擬磁碟無法完成作業,因為其健全狀況或作業狀態不允許。 (50003)
備註
新大小必須位於 MSFT_StoragePool 物件的 GetSupportedSize 方法所提供的有效值範圍內。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
命名空間 | Root\Microsoft\Windows\Storage |
MOF | Storagewmi.mof |