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


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

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

Синтаксис

HRESULT EnumJobs(
  [in]  DWORD                   dwFlags,
  [out] IEnumBackgroundCopyJobs **ppEnum
);

Параметры

[in] dwFlags

Указывает, чьи задания следует включить в перечисление. Если параметр dwFlags имеет значение 0, пользователь получает все задания, которыми он владеет, в очереди передачи. В следующей таблице перечислены параметры перечисления.

Параметр Значение
BG_JOB_ENUM_ALL_USERS
Включает все задания в очереди передачи— принадлежащие пользователю и другие. Чтобы использовать этот флаг, пользователь должен быть администратором.

[out] ppEnum

Указатель интерфейса IEnumBackgroundCopyJobs , который используется для перечисления заданий в очереди передачи. Содержимое перечислителя зависит от значения dwFlags. По завершении отпустите ppEnumJobs .

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

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

Код возврата Описание
S_OK
Объект перечислителя успешно создан.
E_ACCESSDENIED
Пользователь должен быть администратором или принадлежать к группе администраторов для перечисления заданий, принадлежащих другому пользователю.

Требования

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

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

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs