Метод IBackgroundCopyJob::SetNotifyInterface
Определяет реализацию интерфейса IBackgroundCopyCallback для оптимизации доставки. Используйте интерфейс IBackgroundCopyCallback для получения уведомлений о событиях, связанных с заданиями.
Синтаксис
HRESULT SetNotifyInterface(
IUnknown *pNotifyInterface
);
Параметры
-
pNotifyInterface
-
Указатель интерфейса IBackgroundCopyCallback . Чтобы удалить текущий указатель интерфейса обратного вызова, задайте для этого параметра значение NULL.
Возвращаемое значение
Этот метод возвращает следующие значения HRESULT , а также другие.
| Код возврата | Описание |
|---|---|
|
Указатель интерфейса уведомления успешно задан. |
Комментарии
Вызывайте этот метод только при реализации интерфейса IBackgroundCopyCallback . Используйте метод SetNotifyInterface в сочетании с методом SetNotifyFlags , чтобы указать тип уведомления, которое требуется получить.
Интерфейс уведомлений становится недопустимым при завершении работы приложения; Оптимизация доставки не сохраняет интерфейс уведомления. В результате процесс инициализации приложения должен вызвать метод SetNotifyInterface для существующих заданий, для которых требуется получать уведомления. Если вам нужно записать сведения о состоянии и ходе выполнения, произошедшие с момента последнего запуска приложения, опрашивать сведения о состоянии и ходе выполнения во время инициализации приложения.
Зарегистрироваться для получения уведомлений может только владелец или создатель задания или администратор.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 10 версии 1709 [только классические приложения] |
| Минимальная версия сервера |
Windows Server версии 1709 [только классические приложения] |
| Заголовок |
|
| IDL |
|
| Библиотека |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob определяется как 37668D37-507E-4160-9316-26306D150B12 |