Метод IBackgroundCopyQMgr::GetGroup (qmgr.h)

Статья
08/25/2023

[IBackgroundCopyQMgr доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте интерфейсы BITS.]

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

Синтаксис

HRESULT GetGroup(
  [in]  GUID                 groupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Параметры

[in] groupID

GUID, который однозначно идентифицирует группу в очереди загрузки.

[out] ppGroup

Указатель на указатель интерфейса IBackgroundCopyGroup . Используйте этот интерфейс для управления группой. Например, добавьте задание в группу и задайте свойства группы.

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

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

Код возврата	Описание
S_OK	Группа успешно получена.
QM_E_ITEM_NOT_FOUND	Не удалось найти группу в очереди загрузки.

Требования

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

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

IBackgroundCopyQMgr

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