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

Статья
08/22/2023

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

Синтаксис

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.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Windows
Header	bits.h
Библиотека	Bits.lib
DLL	QmgrPrxy.dll