IBackgroundCopyManager

転送ジョブを作成し、キュー内のジョブを含む列挙子オブジェクトを取得し、キューから個々のジョブを取得します。

Windows Vista 以降: ActiveX コントロールが Internet Explorer プロセスからこのインターフェイスをインスタンス化しようとすると、呼び出しはアクセス拒否で失敗します。これは、COM が整合性レベルの低いクライアントからより高い整合性レベルのクラスインスタンスへのバインドを許可しないためです。詳細については、Understanding and Working in Protected Mode Internet Explorer および How the Integrity Mechanism Is Implemented in Windows Vista を参照してください。この問題は、対象の Web サイトを信頼済みサイトゾーンに追加することで回避できます。

ジョブを作成します。

このメソッドは、以下の HRESULT 値のほか、その他の値を返します。

ジョブを作成したユーザー、または管理者権限を持つユーザーのみが、ジョブへのファイルの追加およびジョブのプロパティの変更を行えます。

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

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

スケーラビリティに関する考慮事項については、Best Practices When Using BITS を参照してください。

例

新しいジョブを作成する例については、 Creating a Job を参照してください。

指定したジョブを転送キューから取得します。通常、アプリケーションはジョブ識別子を保存しておき、後でキューからジョブを取得します。

このメソッドは、以下の HRESULT 値のほか、その他の値を返します。

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

このメソッドは、以下の HRESULT 値のほか、その他の値を返します。

指定したエラーコードの説明を取得します。

このメソッドは、以下の HRESULT 値のほか、その他の値を返します。

HTTP エラーの説明はローカライズされます。

Windows XP/2000: HTTP エラーの説明はローカライズされません。

例

次の例は、エラーコードに関連付けられた説明を取得する方法を示しています。例中の g_XferManager 変数は IBackgroundCopyManager インターフェイスポインターです。 IBackgroundCopyManager インターフェイスポインターの作成方法の詳細については、 Connecting to the BITS Service を参照してください。

HRESULT hr = 0;
IBackgroundCopyJob* pJob = NULL;
WCHAR* pszDescription = NULL;

//Call fails because the third parameter is NULL.
hr = g_XferManager->CreateJob(L"DummyJob", BG_JOB_TYPE_DOWNLOAD, NULL, &pJob);
if (FAILED(hr))
{
  hr = g_XferManager->GetErrorDescription(hr, LANGIDFROMLCID(GetThreadLocale()), &pszDescription);
  if (SUCCEEDED(hr))
  {
    //Do something with pszDescription.
    CoTaskMemFree(pszDescription);
  }
}