IVssSoftwareSnapshotProvider：：QueryRevertStatus 方法 (vsprov.h)

  • 發行項

傳回可用來判斷還原作業狀態的 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_INVALIDARG
 其中一個參數值無效。
E_OUTOFMEMORY
 呼叫端記憶體不足或其他系統資源。
VSS_E_OBJECT_NOT_FOUND
 pwszVolume 參數未指定有效的磁碟區。
VSS_E_VOLUME_NOT_SUPPORTED
 此磁碟區不支援還原作業。

備註

即使電腦重新啟動，也無法取消或復原還原作業，但還原使用其他方法建立的備份除外。 IVssAsync：：QueryStatus 方法無法傳回VSS_S_ASYNC_CANCELLED，因為還原作業無法在啟動之後取消。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vsprov.h
程式庫 VssApi.lib

另請參閱

IVssSoftwareSnapshotProvider