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
S_OK	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	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Biblioteca	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager é definido como 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

Confira também

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::Resume