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

發行項
03/13/2024

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

語法

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