Compartilhar via


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

Recupera um trabalho especificado da fila de transferência. Normalmente, seu aplicativo persiste o identificador de trabalho, para que você possa recuperar o trabalho posteriormente da fila.

Sintaxe

HRESULT GetJob(
  [in]  REFGUID            jobID,
  [out] IBackgroundCopyJob **ppJob
);

Parâmetros

[in] jobID

Identifica o trabalho a ser recuperado da fila de transferência. O método CreateJob retorna o identificador de trabalho.

[out] ppJob

Um ponteiro de interface IBackgroundCopyJob para o trabalho especificado por JobID. Quando terminar, solte ppJob.

Retornar valor

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno Descrição
S_OK
O trabalho foi recuperado com êxito da fila de transferência.
BG_E_NOT_FOUND
O trabalho não foi encontrado na fila.
E_ACCESSDENIED
O usuário não tem permissão para recuperar o 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

Confira também

IBackgroundCopyJob

IBackgroundCopyJob::GetId

IBackgroundCopyManager::CreateJob

IBackgroundCopyManager::EnumJobs