共用方式為


IVssBackupComponents::QueryRevertStatus 方法 (vsbackup.h)

QueryRevertStatus 方法會傳回 IVssAsync 介面指標,可用來判斷還原作業的狀態。

語法

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

參數

[in] pwszVolume

以 Null 結尾的寬字元字串,其中包含磁碟區的名稱。 名稱必須是下列其中一種格式,且必須包含尾端反斜杠 (\) :

  • 掛接資料夾的路徑,例如 Y:\MountX\
  • 驅動器號,例如 D:\
  • 格式為 \\?\Volume{GUID}\ 的磁碟區 GUID 路徑 (,其中 GUID 會識別磁碟區)

[out] ppAsync

將接收 IVssAsync 介面指標的位置指標,可用來擷取還原程序的狀態。 當作業完成時,呼叫端必須呼叫 IUnknown::Release 方法來釋放介面指標。

傳回值

這個方法可以傳回下列其中一個值。

意義
S_OK
作業成功。
E_ACCESSDENIED
呼叫進程的許可權不足。
E_FAIL
發生內部錯誤。
E_INVALIDARG
傳遞的其中一個參數無效。
E_NOTIMPL
磁碟區的提供者不支援還原作業。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
E_POINTER
其中一個必要的指標參數是 NULL
VSS_E_OBJECT_NOT_FOUND
pwszVolume 參數不是有效的磁碟區。
VSS_E_VOLUME_NOT_SUPPORTED
此磁碟區不支援還原。

備註

即使計算機重新啟動,還原作業仍會繼續,但無法取消或復原,但還原使用其他方法建立的備份除外。 傳回的 QueryStatus 方法
IVssAsync 介面無法傳回 VSS_S_ASYNC_CANCELLED ,因為還原作業在啟動之後無法取消。

規格需求

需求
最低支援的用戶端 Windows Vista SP1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008、Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot