Método IBackgroundCopyManager::CreateJob
Cria um trabalho.
Sintaxe
HRESULT CreateJob(
[in] LPCWSTR pDisplayName,
[in] BG_JOB_TYPE Type,
[out] GUID *pJobID,
[out] IBackgroundCopyJob **ppJob
);
Parâmetros
-
pDisplayName [in]
-
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.
-
Digite [in]
-
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 .
-
pJobID [out]
-
Identifica exclusivamente seu trabalho na fila. Use esse identificador quando chamar o método IBackgroundCopyManager::GetJob para obter um trabalho da fila.
-
ppJob [out]
-
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.
Valor retornado
Esse método retorna os seguintes valores HRESULT , bem como outros.
| Código de retorno | Descrição |
|---|---|
|
O novo trabalho foi gerado com êxito. |
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 10, versão 1709 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server, versão 1709 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|
| IID |
IID_IBackgroundCopyManager é definido como 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C |