IBackgroundCopyJob：：GetState 方法 (bits.h)

擷取作業的狀態。

語法

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

參數

[out] pVal

作業的狀態。 例如，狀態會反映作業是否發生錯誤、傳輸數據或暫停。 如需作業狀態的清單，請參閱 BG_JOB_STATE 列舉。

傳回值

這個方法會傳回下列 HRESULT 值，以及其他值。

傳回碼	Description
S_OK	已成功擷取作業的狀態。
E_INVALIDARG	參數 pJobState 不能是 NULL。

備註

如果您想要知道作業何時發生錯誤或已傳輸作業中的所有檔案，您可以使用這個方法來輪詢作業的狀態，或者您可以註冊以在事件發生時接收通知。 如需註冊以接收事件通知的詳細資訊，請參閱 IBackgroundCopyCallback 介面。

範例

請參閱 IBackgroundCopyManager：：GetJob 方法的範例程序代碼。

規格需求

需求	值
最低支援的用戶端	Windows XP
最低支援的伺服器	Windows Server 2003
目標平台	Windows
標頭	bits.h
程式庫	Bits.lib
Dll	QmgrPrxy.dll

另請參閱

BG_JOB_STATE， 判斷作業的狀態IBackgroundCopyCallback