IBackgroundCopyQMgr::GetGroup メソッド (qmgr.h)

[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
ヘッダー	qmgr.h
[DLL]	QmgrPrxy.dll

こちらもご覧ください

IBackgroundCopyQMgr