Метод IBackgroundCopyManager::GetJob (bits.h)

Статья
02/23/2024

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

Синтаксис

HRESULT GetJob(
  [in]  REFGUID            jobID,
  [out] IBackgroundCopyJob **ppJob
);

Параметры

[in] jobID

Идентифицирует задание, извлекаемого из очереди передачи. Метод CreateJob возвращает идентификатор задания.

[out] ppJob

Указатель интерфейса IBackgroundCopyJob на задание, указанное jobID. По завершении отпустите ppJob.

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

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

Код возврата	Описание
S_OK	Задание успешно получено из очереди передачи.
BG_E_NOT_FOUND	Задание не найдено в очереди.
E_ACCESSDENIED	Пользователь не имеет разрешения на получение задания.

Требования

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

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

IBackgroundCopyJob

IBackgroundCopyJob::GetId

IBackgroundCopyManager::CreateJob

IBackgroundCopyManager::EnumJobs