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

ジョブを作成します。

構文

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

パラメーター

[in] DisplayName

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

[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 を 使用する場合のベスト プラクティスに関する説明を参照してください。

例示

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

Requirements

こちらも参照ください

ジョブの作成

IBackgroundCopyJob

IBackgroundCopyJob::Resume