IBackgroundCopyQMgr：：GetGroup 方法 (qmgr.h)

[IBackgroundCopyQMgr 可用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請改用 BITS 介面。]

使用 GetGroup 方法可從下載佇列擷取群組。目前的使用者只能擷取他們所擁有的群組。如果使用者具有系統管理員許可權，使用者可以從下載佇列擷取任何群組。從佇列擷取群組會將群組的擁有權轉移給目前的使用者。

語法

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

[in] groupID

可唯一識別下載佇列中群組的 GUID。

[out] ppGroup

IBackgroundCopyGroup 介面指標的指標。使用此介面來管理群組。例如，將作業新增至群組，並設定群組的屬性。

這個方法會傳回下列 HRESULT 值，以及其他值。

傳回碼	Description
S_OK	已成功擷取群組。
QM_E_ITEM_NOT_FOUND	在下載佇列中找不到群組。