Поделиться через

Интерфейс IBackgroundCopyCallback1 (qmgr.h)

  • Статья

[IBackgroundCopyCallback1 доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте интерфейсы BITS.]

Реализуйте интерфейс IBackgroundCopyCallback1 для получения уведомлений при возникновении событий. Приложения используют этот интерфейс в качестве параметра для опроса состояния группы.

Чтобы получать уведомления, вызовите метод IBackgroundCopyGroup::SetProp , чтобы задать свойства GROUPPROP_NOTIFYCLSID и GROUPPROP_NOTIFYFLAGS .

QMGR использует указатель интерфейса, пока он действителен (указатель интерфейса становится недопустимым при выходе из приложения). При перезапуске приложения необходимо сбросить свойство GROUPPROP_NOTIFYCLSID в тех группах, которые QMGR по-прежнему обрабатывает.

Примечание QMGR активирует новый объект внутри область клиентского процесса; уведомления не запускаются в собственном процессе. QMGR создает новый объект этого идентификатора CLSID и передает указатель интерфейса в BITS.
 
Необходимо реализовать все методы интерфейса IBackgroundCopyCallback1 . Как минимум метод должен возвращать S_OK. Чтобы снизить вероятность того, что обратный вызов блокирует BITS, оставьте реализацию короткой.

Если администратор становится владельцем группы, обратные вызовы уведомлений выполняются в контексте пользователя, который запросил уведомление.

Наследование

Интерфейс IBackgroundCopyCallback1 наследуется от интерфейса IUnknown . IBackgroundCopyCallback1 также содержит следующие типы элементов:

Методы

Интерфейс IBackgroundCopyCallback1 содержит следующие методы.

 
IBackgroundCopyCallback1::OnStatus

Реализуйте метод OnStatus для получения уведомлений о завершении группы или возникновении ошибки.

Требования

   
Минимальная версия клиента Windows XP
Минимальная версия сервера Windows Server 2003
Целевая платформа Windows
Header qmgr.h