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

Crea un trabajo.

Sintaxis

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

Parámetros

[in] DisplayName

Cadena terminada en null que contiene un nombre para mostrar para el trabajo. Normalmente, el nombre para mostrar se usa para identificar el trabajo en una interfaz de usuario. Tenga en cuenta que es posible que más de un trabajo tenga el mismo nombre para mostrar. No debe ser NULL. El nombre está limitado a 256 caracteres, no incluido el terminador null.

[in] Type

Tipo de trabajo de transferencia, como BG_JOB_TYPE_DOWNLOAD. Para obtener una lista de los tipos de transferencia, consulte la enumeración BG_JOB_TYPE .

[out] pJobId

Identifica de forma única el trabajo en la cola. Use este identificador al llamar al método IBackgroundCopyManager::GetJob para obtener un trabajo de la cola.

[out] ppJob

Puntero de interfaz IBackgroundCopyJob que se usa para modificar las propiedades del trabajo y especificar los archivos que se van a transferir. Para activar el trabajo en la cola, llame al método IBackgroundCopyJob::Resume . Publique ppJob cuando haya terminado.

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto	Descripción
S_OK	Se generó correctamente el nuevo trabajo.
E_INVALIDARG	El nombre para mostrar es demasiado largo.
BG_E_TOO_MANY_JOBS_PER_MACHINE	La configuración de maxJobsPerMachine directiva de grupo determina cuántos trabajos se pueden crear en el equipo. Al agregar este trabajo, se supera el límite de MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER	La configuración de maxJobsPerUser directiva de grupo determina cuántos trabajos puede crear un usuario. Agregar este trabajo supera el límite maxJobsPerUser.

Comentarios

Solo el usuario que crea el trabajo o un usuario con privilegios de administrador puede agregar archivos al trabajo y cambiar las propiedades del trabajo.

De forma predeterminada, BITS admite un máximo de 300 trabajos a la vez. Un único usuario puede crear un máximo de 60 trabajos a la vez. El límite de usuarios no se aplica a los administradores ni a las cuentas de servicio. Para cambiar estos valores predeterminados, establezca las directivas de grupo MaxJobsPerMachine y MaxJobsPerUser , respectivamente.

Antes de Windows Vista: No hay ningún límite en el número de trabajos que BITS admite o que un usuario puede crear.

Para conocer los problemas de escalabilidad, consulte Procedimientos recomendados al usar BITS.

Ejemplos

Para ver un ejemplo que crea un nuevo trabajo, consulte Creación de un trabajo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Plataforma de destino	Windows
Encabezado	bits.h
Library	Bits.lib
Archivo DLL	QmgrPrxy.dll

Consulte también

Creación de un trabajo

IBackgroundCopyJob

IBackgroundCopyJob::Resume