Método IBackgroundCopyJob::GetState (bits.h)
Recupera el estado del trabajo.
Sintaxis
HRESULT GetState(
[out] BG_JOB_STATE *pVal
);
Parámetros
[out] pVal
Estado del trabajo. Por ejemplo, el estado refleja si el trabajo está en error, la transferencia de datos o la suspensión. Para obtener una lista de estados de trabajo, consulte la enumeración BG_JOB_STATE .
Valor devuelto
Este método devuelve los siguientes valores HRESULT , así como otros.
Código devuelto | Descripción |
---|---|
|
El estado del trabajo se recuperó correctamente. |
|
El parámetro pJobState no puede ser NULL. |
Comentarios
Si desea saber cuándo un trabajo está en error o ha transferido todos los archivos del trabajo, puede usar este método para sondear el estado del trabajo o puede registrarse para recibir notificaciones cuando se produzcan eventos. Para obtener más información sobre el registro para recibir la notificación de eventos, consulte la interfaz IBackgroundCopyCallback .
Ejemplos
Vea el código de ejemplo del método IBackgroundCopyManager::GetJob .
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP |
Servidor mínimo compatible | Windows Server 2003 |
Plataforma de destino | Windows |
Encabezado | bits.h |
Library | Bits.lib |
Archivo DLL | QmgrPrxy.dll |
Consulte también
BG_JOB_STATE, Determinar el estado de un trabajo, IBackgroundCopyCallback