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

O BITS chama sua implementação do método JobModification quando o trabalho foi modificado. O serviço gera esse evento quando os bytes são transferidos, os arquivos foram adicionados ao trabalho, as propriedades foram modificadas ou o estado do trabalho foi alterado.

Sintaxe

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

Parâmetros

[in] pJob

Contém os métodos para acessar a propriedade, o progresso e as informações de estado do trabalho. Não liberar pJob; O BITS libera a interface quando o método JobModification retorna.

[in] dwReserved

Reservado para uso futuro.

Retornar valor

Esse método deve retornar S_OK.

Comentários

Sua implementação pode não receber todos os eventos de modificação em condições máximas de carga de recursos.

O BITS gera um grande volume de eventos de modificação; considere criar um temporizador e sondar informações de estado e progresso ou limitar o uso desse retorno de chamada. Se você usar esse retorno de chamada, mantenha sua implementação curta.

O BITS não gera um evento de modificação quando o estado do trabalho é alterado para BG_JOB_STATE_ERROR ou BG_JOB_STATE_TRANSFERRED.

Nota O BITS dá suporte a até quatro notificações simultâneas por usuário. Se um ou mais aplicativos bloquearem o retorno de todas as quatro notificações para um usuário, um aplicativo em execução como o mesmo usuário não receberá notificações até que uma ou mais notificações de bloqueio retornem.

 

Exemplos

Consulte o código de exemplo para a interface IBackgroundCopyCallback .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Servidor mínimo com suporte	Windows Server 2003
Plataforma de Destino	Windows
Cabeçalho	bits.h

Confira também

IBackgroundCopyCallback

IBackgroundCopyJob