MSFT_VirtualDisk 類別的 CreateSnapshot 方法
建立新的虛擬磁碟，這是現有虛擬磁碟的陰影複製。
語法
UInt32 CreateSnapshot(
[in] String FriendlyName,
[in] String TargetStoragePoolName,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedVirtualDisk,
[out] String ExtendedStatus
);
參數
FriendlyName [in]
陰影複製虛擬磁碟所需的名稱。
這個參數是必要的，而且不能是 NULL。
TargetStoragePoolName [in]
應該用來保存已建立快照集的存放集區。 如果未設定此參數，這個方法會預設為使用包含來源虛擬磁碟的相同存放集區。
RunAsJob [in]
如果 為 TRUE，這個方法會在要求需要很長的時間才能服務時使用 CreatedStorageJob 參數。 如果已建立記憶體作業來追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。
注意
即使 RunAsJob 為 TRUE，此方法仍可在有足夠的時間完成時傳回結果。
如果 為 FALSE 或 NULL，這個方法會遵循預設 WMI 異步行為，如用戶端的叫用方法所決定。 換句話說，除非另有要求，否則它是同步的。
CreatedStorageJob [out]
如果 RunAsJob 設定為 TRUE ，而且這個方法需要很長的時間才能執行，則此參數會收到用來追蹤長時間執行作業之記憶體作業對象的參考。
CreatedVirtualDisk [out]
如果成功建立虛擬磁碟，此參數會收到包含內嵌 MSFT_VirtualDisk 物件的字串。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
已檢查方法參數 - 作業啟動 (4096)
沒有足夠的可用空間 (40000)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
快取過期 (40003)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
在預備儲存集區上不支援此作業。 (48000)
儲存集區僅保留供特殊使用。 (48001)
找不到指定的存放集區。 (48005)
儲存集區無法完成作業，因為其健全狀況或作業狀態不允許。 (48006)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| 標頭 | Dbdaoint.h |
| MOF | Storagewmi.mof |