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

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

Синтаксис

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

Параметры

[in] Val

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

Ценность	Meaning
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 , а также другие.

Код возврата	Description
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
целевая платформа	Виндоус
Header	bits.h
Library	Bits.lib
DLL	QmgrPrxy.dll

См. также

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface