IVssAsync::QueryStatus 方法 (vss.h)
QueryStatus方法會查詢非同步作業的狀態。
語法
HRESULT QueryStatus(
[out] HRESULT *pHrResult,
[out] INT *pReserved
);
參數
[out] pHrResult
傳回目前 IVssAsync 物件的非同步作業狀態。
所有IVssAsync物件的QueryStatus呼叫都支援下列狀態碼。
值 | 意義 |
---|---|
|
非同步作業已由先前呼叫 IVssAsync::Cancel 取消。 |
|
非同步作業已順利完成。 |
|
非同步作業仍在執行中。 |
可以傳回其他傳回值,但取決於最初傳回 IVssAsync 物件的方法傳回碼。
[out] pReserved
此參數的值應該是 Null。
傳回值
以下是這個方法的有效傳回碼。
值 | 意義 |
---|---|
|
查詢作業成功。 |
|
查詢作業失敗,因為使用者沒有正確的許可權。 |
|
用來保存 pHrResult 傳回值的變數指標是 Null ,或不是有效的記憶體位置。 |
|
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 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 |
另請參閱
IVssBackupComponents::D oSnapshotSet
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::GatherWriterStatus
IVssBackupComponents::ImportSnapshots
IVssBackupComponents::P ostRestore