Compartilhar via

Interface IBackgroundCopyCallback1 (qmgr.h)

  • Artigo

[IBackgroundCopyCallback1 está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use as interfaces BITS.]

Implemente a interface IBackgroundCopyCallback1 para receber notificação quando ocorrerem eventos. Os aplicativos usam essa interface como uma opção para sondar o estado do grupo.

Para receber notificações, chame o método IBackgroundCopyGroup::SetProp para definir as propriedades GROUPPROP_NOTIFYCLSID e GROUPPROP_NOTIFYFLAGS .

O QMGR usa o ponteiro da interface enquanto é válido (o ponteiro da interface se torna inválido quando o aplicativo é encerrado). Quando o aplicativo é reiniciado, você deve redefinir a propriedade GROUPPROP_NOTIFYCLSID nesses grupos que o QMGR ainda está processando.

Nota O QMGR ativa o novo objeto dentro do escopo do processo do cliente; as notificações não são executadas em seu próprio processo. O QMGR cria um novo objeto desse CLSID e passa um ponteiro de interface para BITS.
 
Você deve implementar todos os métodos da interface IBackgroundCopyCallback1 . No mínimo, o método deve retornar S_OK. Para reduzir a chance de que o retorno de chamada bloqueie BITS, mantenha sua implementação curta.

Se um administrador assumir a propriedade do grupo, os retornos de chamada de notificação serão feitos no contexto do usuário que solicitou a notificação.

Herança

A interface IBackgroundCopyCallback1 herda da interface IUnknown . IBackgroundCopyCallback1 também tem estes tipos de membros:

Métodos

A interface IBackgroundCopyCallback1 tem esses métodos.

 
IBackgroundCopyCallback1::OnStatus

Implemente o método OnStatus para receber notificação quando o grupo for concluído ou ocorrer um erro.

Requisitos

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