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 參數。 如果已建立記憶體作業來追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。

如果 為 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)

規格需求

另請參閱

MSFT_VirtualDisk