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

ジョブを作成します。

構文

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

パラメーター

[in] DisplayName

ジョブの表示名を含む Null で終わる文字列。 通常、表示名は、ユーザー インターフェイスでジョブを識別するために使用されます。 複数のジョブが同じ表示名を持つ場合があることに注意してください。 NULL にすることはできません。 名前は 256 文字に制限され、null ターミネータは含まれません。

[in] Type

転送ジョブの種類 (BG_JOB_TYPE_DOWNLOADなど)。 転送の種類の一覧については、 BG_JOB_TYPE 列挙を参照してください。

[out] pJobId

キュー内のジョブを一意に識別します。 この識別子は、 IBackgroundCopyManager::GetJob メソッドを呼び出してキューからジョブを取得するときに使用します。

[out] ppJob

ジョブのプロパティを変更し、転送するファイルを指定するために使用する IBackgroundCopyJob インターフェイス ポインター。 キュー内のジョブをアクティブ化するには、 IBackgroundCopyJob::Resume メソッドを呼び出します。 完了したら ppJob を リリースします。

戻り値

このメソッドは、次の HRESULT 値と他の値を返します。

注釈

ジョブを作成するユーザー、または管理者特権を持つユーザーのみが 、ジョブにファイルを追加 して ジョブのプロパティを変更できます。

既定では、BITS では一度に最大 300 個のジョブがサポートされます。 1 人のユーザーは、一度に最大 60 個のジョブを作成できます。 ユーザー制限は、管理者またはサービス アカウントには適用されません。 これらの既定値を変更するには、 それぞれ MaxJobsPerMachine グループ ポリシーと MaxJobsPerUser グループ ポリシーを設定します。

Windows Vista より前: BITS でサポートされるジョブの数や、ユーザーが作成できるジョブの数に制限はありません。

スケーラビリティの問題については、「BITS を 使用するときのベスト プラクティス」を参照してください。

例

新しいジョブを作成する例については、「ジョブ の作成」を参照してください。

要件

こちらもご覧ください

ジョブの作成

IBackgroundCopyJob

IBackgroundCopyJob::Resume