共用方式為


IVssBackupComponents::D oSnapshotSet 方法 (vsbackup.h)

同時認可此集合中的所有陰影複製。

語法

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

參數

[out] ppAsync

必要 IVssAsync 異步介面的雙間接指標。 這會用來查詢方法執行狀態,並擷取最終的錯誤碼。

傳回值

以下是這個方法的有效傳回碼。 這些錯誤碼可能會從這個方法傳回,或是從 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。

意義
S_OK
已成功傳回 IVssAsync 介面實例的指標。 如需 pHrResult 參數所傳回的有效值,請參閱 IVssAsync::QueryStatus
E_ACCESSDENIED
呼叫端沒有足夠的備份許可權,或不是系統管理員。
E_INVALIDARG
ppAsync 未指向有效的指標;也就是說,它是 NULL
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
備份元件物件尚未初始化,或呼叫 DoSnapshotSet 之前,尚未對指定的陰影複製內容進行必要條件呼叫。
VSS_E_INSUFFICIENT_STORAGE
系統或提供者的儲存空間不足。 如果可能的話,請刪除任何舊的或不必要的永續性陰影複製,然後再試一次。 此錯誤碼只會透過 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。
VSS_E_FLUSH_WRITES_TIMEOUT
系統無法排清 I/O 寫入。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。
VSS_E_HOLD_WRITES_TIMEOUT
系統無法保存 I/O 寫入。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。
VSS_E_NESTED_VOLUME_LIMIT
指定的磁碟區巢狀太深,無法參與 VSS 作業。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支援此傳回碼。

VSS_E_PROVIDER_VETO
提供者目前無法執行要求。 這可以是暫時性的問題。 建議等候 10 分鐘,然後再試一次,最多三次。 此錯誤碼只會透過 ppAsync 參數中傳回之 IVssAsync 介面上的 QueryStatus 方法傳回。
VSS_E_REBOOT_REQUIRED
提供者遇到需要使用者重新啟動計算機的錯誤。

Windows Server 2003 和 Windows XP: 不支援這個值。

VSS_E_TRANSACTION_FREEZE_TIMEOUT
系統無法凍結分散式交易協調器 (DTC) 或核心交易管理員 (KTM) 。

Windows Server 2003 和 Windows XP: 不支援這個值。

VSS_E_TRANSACTION_THAW_TIMEOUT
系統無法解除凍結分散式交易協調器 (DTC) 或核心交易管理員 (KTM) 。

Windows Server 2003 和 Windows XP: 不支援這個值。

VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 E_UNEXPECTED改用。

VSS_E_UNEXPECTED_PROVIDER_ERROR
提供者傳回非預期的錯誤碼。 這可以是暫時性的問題。 建議等候 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

另請參閱

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet