IVssAsync::QueryStatus 方法 (vss.h)

QueryStatus方法會查詢非同步作業的狀態。

語法

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] INT     *pReserved
);

參數

[out] pHrResult

傳回目前 IVssAsync 物件的非同步作業狀態。

所有IVssAsync物件的QueryStatus呼叫都支援下列狀態碼。

意義
VSS_S_ASYNC_CANCELLED
非同步作業已由先前呼叫 IVssAsync::Cancel 取消
VSS_S_ASYNC_FINISHED
非同步作業已順利完成。
VSS_S_ASYNC_PENDING
非同步作業仍在執行中。
 

可以傳回其他傳回值,但取決於最初傳回 IVssAsync 物件的方法傳回碼。

[out] pReserved

此參數的值應該是 Null

傳回值

以下是這個方法的有效傳回碼。

意義
S_OK
查詢作業成功。
E_ACCESSDENIED
查詢作業失敗,因為使用者沒有正確的許可權。
E_INVALIDARG
用來保存 pHrResult 傳回值的變數指標是 Null ,或不是有效的記憶體位置。
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

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

備註

在非同步作業期間發生錯誤時, QueryStatus 會傳回與最初傳回 IVssAsync 物件之方法相同的錯誤碼。

若要取得特定方法所傳回 之 IVssAsync::QueryStatus 物件的完整傳回值清單,請參閱針對該方法記載的錯誤碼。

規格需求

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

另請參閱

IVssAsync

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::GatherWriterStatus

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::P ostRestore

IVssBackupComponents::P reRestore

IVssBackupComponents::P repareForBackup