Criando um trabalho

Para criar um trabalho de transferência, chame o método IBackgroundCopyManager::CreateJob . Depois que o BITS criar o trabalho, adicione arquivos ao trabalho e modifique as propriedades do trabalho conforme apropriado para seu aplicativo. Para ativar o trabalho na fila, chame o método IBackgroundCopyJob::Resume .

O método CreateJob cria um GUID que identifica exclusivamente o trabalho. Use o GUID para recuperar o trabalho da fila de transferência. O nome para exibição fornecido ao criar o trabalho não é exclusivo; mais de um trabalho pode usar o mesmo nome.

O BITS limita o número de trabalhos na fila a 300 trabalhos e o número de trabalhos que um usuário pode criar a 60 trabalhos. Esses limites não se aplicam a administradores ou serviços. Para alterar esses limites padrão, consulte Diretivas de Grupo.

O exemplo a seguir mostra como criar um trabalho de download. O exemplo assume que a variável g_pbcm é um ponteiro de interface IBackgroundCopyManager válido. Para obter detalhes sobre como criar o ponteiro de interface IBackgroundCopyManager, consulte Conectando-se ao serviço BITS.

HRESULT hr;
GUID JobId;
IBackgroundCopyJob* pJob = NULL;

//To create an upload job, replace BG_JOB_TYPE_DOWNLOAD with 
//BG_JOB_TYPE_UPLOAD or BG_JOB_TYPE_UPLOAD_REPLY.
hr = g_pbcm->CreateJob(L"MyJobName", BG_JOB_TYPE_DOWNLOAD, &JobId, &pJob);
if (SUCCEEDED(hr))
{
  //Save the JobId for later reference. 
  //Modify the job's property values.
  //Add files to the job.
  //Activate (resume) the job in the transfer queue.
}

Para obter a interface IBackgroundCopyJob mais recente, chame o método IBackgroundCopyJob::QueryInterface. O exemplo a seguir mostra como obter a interface IBackgroundCopyJob5.

  HRESULT hr = S_OK;
  IBackgroundCopyJob* pJob = NULL;
  IBackgroundCopyJob5* pJob5 = NULL;

  hr = pJob->QueryInterface(__uuidof(IBackgroundCopyJob5), (void**)&pJob5);
  pJob->Release();
  if (FAILED(hr))
  {
    wprintf(L"pJob->QueryInterface failed with 0x%x.\n", hr);
    goto cleanup;
  }