Метод IBackgroundCopyJob::SetNotifyFlags (bits.h)
Указывает тип уведомления о событии, которое вы хотите получить, например события, переданные заданиями.
Синтаксис
HRESULT SetNotifyFlags(
[in] ULONG Val
);
Параметры
[in] Val
Установите один или несколько из следующих флагов, чтобы определить события, которые вы хотите получить.
| Значение | Значение |
|---|---|
|
Все файлы в задании перенесены. |
|
Произошла ошибка. |
|
Уведомление о событиях отключено. BITS игнорирует другие флаги. |
|
Задание было изменено. Например, изменено значение свойства, изменено состояние задания или выполняется передача файлов. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки . |
|
Файл в задании передан. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки . |
|
Был передан диапазон байтов в файле. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки . Флаг можно указать для любого задания, но вы будете получать уведомления только о заданиях, соответствующих требованиям для BITS_JOB_PROPERTY_ON_DEMAND_MODE задания. |
Возвращаемое значение
Этот метод возвращает следующие значения HRESULT , а также другие.
| Код возврата | Описание |
|---|---|
|
Тип уведомления о событии успешно задан. |
|
Недопустимое значение NotifyFlags . |
|
Состояние задания не может быть BG_JOB_STATE_CANCELLED или BG_JOB_STATE_ACKNOWLEDGED. |
Комментарии
Для получения уведомлений о событии используйте метод SetNotifyFlags в сочетании с методами IBackgroundCopyJob::SetNotifyInterface и IBackgroundCopyJob2::SetNotifyCmdLine .
Примеры
См. пример кода для метода IBackgroundCopyJob::SetNotifyInterface .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP |
| Минимальная версия сервера | Windows Server 2003 |
| Целевая платформа | Windows |
| Header | bits.h |
| Библиотека | Bits.lib |
| DLL | QmgrPrxy.dll |
См. также раздел
IBackgroundCopyJob2::SetNotifyCmdLine