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
ダウンロード キューにグループが見つかりませんでした。

Requirements

Requirement 価値
サポートされる最小クライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
ターゲット プラットフォーム ウィンドウズ
Header qmgr.h
DLL QmgrPrxy.dll

こちらも参照ください

IBackgroundCopyQMgr