Метод IBackgroundCopyCallback::JobModification (bits.h)

Статья
08/22/2023

BITS вызывает реализацию метода JobModification при изменении задания. Служба создает это событие при передаче байтов, добавлении файлов в задание, изменении свойств или изменении состояния задания.

Синтаксис

HRESULT JobModification(
  [in] IBackgroundCopyJob *pJob,
  [in] DWORD              dwReserved
);

Параметры

[in] pJob

Содержит методы для доступа к сведениям о свойстве, ходе выполнения и состоянии задания. Не выпускайте pJob; BITS освобождает интерфейс при возврате метода JobModification .

[in] dwReserved

Зарезервировано для последующего использования.

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

Этот метод должен возвращать S_OK.

BITS создает большой объем событий изменения; рассмотрите возможность создания таймера и опроса для получения сведений о состоянии и ходе выполнения или ограничения использования этого обратного вызова. Если вы используете этот обратный вызов, оставьте реализацию короткой.

BITS не создает событие изменения, когда состояние задания изменяется на BG_JOB_STATE_ERROR или BG_JOB_STATE_TRANSFERRED.

Примечание BITS поддерживает до четырех одновременных уведомлений для каждого пользователя. Если одно или несколько приложений блокируют возврат всех четырех уведомлений для пользователя, приложение, работающее от имени одного и того же пользователя, не будет получать уведомления до тех пор, пока не вернется одно или несколько блокирующих уведомлений.

Примеры

См. пример кода для интерфейса IBackgroundCopyCallback .

Требования

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

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

IBackgroundCopyCallback

IBackgroundCopyJob

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