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

Статья
02/28/2024

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

Синтаксис

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

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