Método IBackgroundCopyManager::CreateJob (bits.h)

Cria um trabalho.

Sintaxe

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

Parâmetros

[in] DisplayName

Cadeia de caracteres terminada em nulo que contém um nome de exibição para o trabalho. Normalmente, o nome de exibição é usado para identificar o trabalho em uma interface do usuário. Observe que mais de um trabalho pode ter o mesmo nome de exibição. Não deve ser NULL. O nome é limitado a 256 caracteres, sem incluir o terminador nulo.

[in] Type

Tipo de trabalho de transferência, como BG_JOB_TYPE_DOWNLOAD. Para obter uma lista de tipos de transferência, consulte a enumeração BG_JOB_TYPE .

[out] pJobId

Identifica exclusivamente seu trabalho na fila. Use esse identificador quando você chamar o método IBackgroundCopyManager::GetJob para obter um trabalho da fila.

[out] ppJob

Um ponteiro de interface IBackgroundCopyJob que você usa para modificar as propriedades do trabalho e especificar os arquivos a serem transferidos. Para ativar o trabalho na fila, chame o método IBackgroundCopyJob::Resume . Libere ppJob quando terminar.

Valor de retorno

Esse método retorna os seguintes valores HRESULT , bem como outros.

Observações

Somente o usuário que cria o trabalho ou um usuário com privilégios de administrador pode adicionar arquivos ao trabalho e alterar as propriedades do trabalho.

Por padrão, o BITS dá suporte a no máximo 300 trabalhos ao mesmo tempo. Um único usuário pode criar no máximo 60 trabalhos ao mesmo tempo. O limite de usuário não se aplica a administradores ou contas de serviço. Para alterar esses padrões, defina as políticas de grupo MaxJobsPerMachine e MaxJobsPerUser , respectivamente.

Antes do Windows Vista: Não há limite para o número de trabalhos que o BITS dá suporte ou que um usuário pode criar.

Para obter preocupações de escalabilidade, consulte as práticas recomendadas ao usar BITS.

Exemplos

Para obter um exemplo que cria um novo trabalho, consulte Criando um trabalho.

Requirements

Consulte também

Criando um trabalho

IBackgroundCopyJob

IBackgroundCopyJob::Resume