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, 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 |
|---|---|
|
O novo trabalho foi gerado com êxito. |
|
O nome de exibição é muito longo. |
|
A configuração de Política de Grupo MaxJobsPerMachine determina quantos trabalhos podem ser criados no computador. Adicionar esse trabalho excede o limite MaxJobsPerMachine. |
|
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 |