IVssBackupComponents::D oSnapshotSet 方法 (vsbackup.h)
同時認可此集合中的所有陰影複製。
語法
HRESULT DoSnapshotSet(
[out] IVssAsync **ppAsync
);
參數
[out] ppAsync
必要 IVssAsync 異步介面的雙間接指標。 這會用來查詢方法執行狀態,並擷取最終的錯誤碼。
傳回值
以下是這個方法的有效傳回碼。 這些錯誤碼可能會從這個方法傳回,或是從 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。
值 | 意義 |
---|---|
|
已成功傳回 IVssAsync 介面實例的指標。 如需 pHrResult 參數所傳回的有效值,請參閱 IVssAsync::QueryStatus。 |
|
呼叫端沒有足夠的備份許可權,或不是系統管理員。 |
|
ppAsync 未指向有效的指標;也就是說,它是 NULL。 |
|
呼叫端記憶體不足或其他系統資源。 |
|
備份元件物件尚未初始化,或呼叫 DoSnapshotSet 之前,尚未對指定的陰影複製內容進行必要條件呼叫。 |
|
系統或提供者的儲存空間不足。 如果可能的話,請刪除任何舊的或不必要的永續性陰影複製,然後再試一次。 此錯誤碼只會透過 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。 |
|
系統無法排清 I/O 寫入。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。 |
|
系統無法保存 I/O 寫入。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。 |
|
指定的磁碟區巢狀太深,無法參與 VSS 作業。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支援此傳回碼。 |
|
提供者目前無法執行要求。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。 此錯誤碼只會透過 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。 |
|
提供者遇到需要使用者重新啟動計算機的錯誤。
Windows Server 2003 和 Windows XP: 不支援這個值。 |
|
系統無法凍結分散式交易協調器 (DTC) 或核心交易管理員 (KTM) 。
Windows Server 2003 和 Windows XP: 不支援這個值。 |
|
系統無法解除凍結分散式交易協調器 (DTC) 或核心交易管理員 (KTM) 。
Windows Server 2003 和 Windows XP: 不支援這個值。 |
|
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 E_UNEXPECTED改用。 |
|
提供者傳回非預期的錯誤碼。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。 此錯誤碼只會透過 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。 |
備註
呼叫端負責釋放 IVssAsync 介面。
無法針對位於另一個 VHD 內巢狀的虛擬硬碟 (VHD) 呼叫這個方法。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支援 VHD。
如需如何使用 IVssBackupComponents::D oSnapshotSet 建立標準備份陰影複製的資訊,請參閱 備份前 工作的概觀和 備份的簡單陰影複製建立。 如需如何在不同 VSS 內容下使用方法的資訊,請參閱 建立陰影複製的實作詳細數據。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
程式庫 | VssApi.lib |
另請參閱
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet