IBackgroundCopyManager::CreateJob (Método)
Crea un trabajo.
Sintaxis
HRESULT CreateJob(
[in] LPCWSTR pDisplayName,
[in] BG_JOB_TYPE Type,
[out] GUID *pJobID,
[out] IBackgroundCopyJob **ppJob
);
Parámetros
-
pDisplayName [in]
-
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.
-
Tipo [in]
-
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 .
-
pJobID [out]
-
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.
-
ppJob [out]
-
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 |
|---|---|
|
Se generó correctamente el nuevo trabajo. |
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server, versión 1709 [solo aplicaciones de escritorio] |
| Encabezado |
|
| IDL |
|
| Biblioteca |
|
| Archivo DLL |
|
| IID |
IID_IBackgroundCopyManager se define como 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C |