Compartir a través de

Método IBackgroundCopyCallback::JobModification (bits.h)

  • Artículo

BITS llama a la implementación del método JobModification cuando se ha modificado el trabajo. El servicio genera este evento cuando se transfieren bytes, se han agregado archivos al trabajo, se han modificado las propiedades o el estado del trabajo ha cambiado.

Sintaxis

HRESULT JobModification(
  [in] IBackgroundCopyJob *pJob,
  [in] DWORD              dwReserved
);

Parámetros

[in] pJob

Contiene los métodos para acceder a la propiedad, el progreso y la información de estado del trabajo. No libere pJob; BITS libera la interfaz cuando devuelve el método JobModification .

[in] dwReserved

Reservado para uso futuro.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

Es posible que la implementación no reciba todos los eventos de modificación en condiciones máximas de carga de recursos.

BITS genera un gran volumen de eventos de modificación; considere la posibilidad de crear un temporizador y sondear la información de estado y progreso o limitar el uso de esta devolución de llamada. Si usa esta devolución de llamada, mantenga la implementación corta.

BITS no genera un evento modify cuando el estado del trabajo cambia a BG_JOB_STATE_ERROR o BG_JOB_STATE_TRANSFERRED.

Nota BITS admite hasta cuatro notificaciones simultáneas por usuario. Si una o varias aplicaciones bloquean la devolución de las cuatro notificaciones de un usuario, una aplicación que se ejecuta como el mismo usuario no recibirá notificaciones hasta que se devuelvan una o varias de las notificaciones de bloqueo.
 

Ejemplos

Consulte el código de ejemplo de la interfaz IBackgroundCopyCallback .

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP
Servidor mínimo compatible Windows Server 2003
Plataforma de destino Windows
Encabezado bits.h

Consulte también

IBackgroundCopyCallback

IBackgroundCopyJob