IBackgroundCopyManager::EnumJobs メソッド (bits.h)

転送キュー内のジョブを列挙するために使用する列挙子オブジェクトへのインターフェイスポインターを取得します。列挙子内のジョブの順序は任意です。

構文

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	別のユーザーが所有するジョブを列挙するには、ユーザーが管理者であるか、管理者グループに属している必要があります。