IBackgroundCopyJob::GetState 方法 (bits.h)
擷取作業的狀態。
語法
HRESULT GetState(
[out] BG_JOB_STATE *pVal
);
參數
[out] pVal
作業的狀態。 例如,狀態會反映作業是否發生錯誤、傳輸數據或暫停。 如需作業狀態的清單,請參閱 BG_JOB_STATE 列舉。
傳回值
這個方法會傳回下列 HRESULT 值,以及其他值。
傳回碼 | Description |
---|---|
|
已成功擷取作業的狀態。 |
|
參數 pJobState 不能是 NULL。 |
備註
如果您想要知道作業何時發生錯誤或已傳輸作業中的所有檔案,您可以使用這個方法來輪詢作業的狀態,或者您可以註冊以在事件發生時接收通知。 如需註冊以接收事件通知的詳細資訊,請參閱 IBackgroundCopyCallback 介面。
範例
請參閱 IBackgroundCopyManager::GetJob 方法的範例程序代碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP |
最低支援的伺服器 | Windows Server 2003 |
目標平台 | Windows |
標頭 | bits.h |
程式庫 | Bits.lib |
Dll | QmgrPrxy.dll |