Interfaz IBackgroundCopyCallback1 (qmgr.h)

[IBackgroundCopyCallback1 está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use las interfaces BITS.]

Implemente la interfaz IBackgroundCopyCallback1 para recibir notificaciones cuando se produzcan eventos. Las aplicaciones usan esta interfaz como opción para sondear el estado del grupo.

Para recibir notificaciones, llame al método IBackgroundCopyGroup::SetProp para establecer las propiedades GROUPPROP_NOTIFYCLSID y GROUPPROP_NOTIFYFLAGS .

QMGR usa el puntero de interfaz mientras es válido (el puntero de interfaz deja de ser válido cuando se cierra la aplicación). Cuando se reinicie la aplicación, debe restablecer la propiedad GROUPPROP_NOTIFYCLSID en los grupos que QMGR sigue procesando.

Nota QMGR activa el nuevo objeto dentro del ámbito del proceso de cliente; las notificaciones no se ejecutan en su propio proceso. QMGR crea un nuevo objeto de ese CLSID y pasa un puntero de interfaz a BITS.

 

Debe implementar todos los métodos de la interfaz IBackgroundCopyCallback1 . Como mínimo, el método debe devolver S_OK. Para reducir la posibilidad de que la devolución de llamada bloquee BITS, mantenga la implementación corta.

Si un administrador toma posesión del grupo, las devoluciones de llamada de notificación se realizan en el contexto del usuario que solicitó la notificación.

Herencia

La interfaz IBackgroundCopyCallback1 hereda de la interfaz IUnknown . IBackgroundCopyCallback1 también tiene estos tipos de miembros:

Métodos

La interfaz IBackgroundCopyCallback1 tiene estos métodos.

IBackgroundCopyCallback1::OnStatus Implemente el método OnStatus para recibir una notificación cuando se complete el grupo o se produzca un error.

Requisitos

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