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


Метод IBackgroundCopyJob::SetNotifyFlags (bits.h)

Указывает тип уведомления о событии, которое вы хотите получить, например события, переданные заданиями.

Синтаксис

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

Параметры

[in] Val

Установите один или несколько из следующих флагов, чтобы определить события, которые вы хотите получить.

Значение Значение
BG_NOTIFY_JOB_TRANSFERRED
0x0001
Все файлы в задании перенесены.
BG_NOTIFY_JOB_ERROR
0x0002
Произошла ошибка.
BG_NOTIFY_DISABLE
0x0004
Уведомление о событиях отключено. BITS игнорирует другие флаги.
BG_NOTIFY_JOB_MODIFICATION
0x0008
Задание было изменено. Например, изменено значение свойства, изменено состояние задания или выполняется передача файлов. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки .
BG_NOTIFY_FILE_TRANSFERRED
0x0010
Файл в задании передан. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки .
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
Был передан диапазон байтов в файле. Этот флаг игнорируется в обратных вызовах командной строки, если указано уведомление командной строки . Флаг можно указать для любого задания, но вы будете получать уведомления только о заданиях, соответствующих требованиям для BITS_JOB_PROPERTY_ON_DEMAND_MODE задания.

Возвращаемое значение

Этот метод возвращает следующие значения HRESULT , а также другие.

Код возврата Описание
S_OK
Тип уведомления о событии успешно задан.
E_NOTIMPL
Недопустимое значение NotifyFlags .
BG_E_INVALID_STATE
Состояние задания не может быть 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

См. также раздел

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface