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

  • Artigo

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, não incluindo 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 ao 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 . Solte ppJob quando terminar.

Retornar valor

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

Código de retorno Descrição
S_OK
 O novo trabalho foi gerado com êxito.
E_INVALIDARG
 O nome de exibição é muito longo.
BG_E_TOO_MANY_JOBS_PER_MACHINE
 A configuração de Política de Grupo MaxJobsPerMachine determina quantos trabalhos podem ser criados no computador. Adicionar esse trabalho excede o limite MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER
 A configuração de Política de Grupo MaxJobsPerUser determina quantos trabalhos um usuário pode criar. Adicionar esse trabalho excede o limite de MaxJobsPerUser.

Comentários

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 um máximo de 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 aos quais o BITS dá suporte ou que um usuário pode criar.

Para saber mais sobre escalabilidade, confira Práticas recomendadas ao usar BITS.

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

Criando um trabalho

IBackgroundCopyJob

IBackgroundCopyJob::Resume