Compartilhar via


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

Recupera um ponteiro de interface para um objeto enumerador que você usa para enumerar os trabalhos na fila de transferência. A ordem dos trabalhos no enumerador é arbitrária.

Sintaxe

HRESULT EnumJobs(
  [in]  DWORD                   dwFlags,
  [out] IEnumBackgroundCopyJobs **ppEnum
);

Parâmetros

[in] dwFlags

Especifica cujos trabalhos devem ser incluídos na enumeração. Se dwFlags estiver definido como 0, o usuário receberá todos os trabalhos que possui na fila de transferência. A tabela a seguir lista as opções de enumeração.

Opção Significado
BG_JOB_ENUM_ALL_USERS
Inclui todos os trabalhos na fila de transferência , aqueles pertencentes ao usuário e aqueles pertencentes a outras pessoas. O usuário deve ser um administrador para usar esse sinalizador.

[out] ppEnum

Um ponteiro de interface IEnumBackgroundCopyJobs que você usa para enumerar os trabalhos na fila de transferência. O conteúdo do enumerador depende do valor de dwFlags. Solte ppEnumJobs quando terminar.

Retornar valor

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

Código de retorno Descrição
S_OK
Objeto enumerador gerado com êxito.
E_ACCESSDENIED
O usuário deve ser um administrador ou pertencer a um grupo de administradores para enumerar trabalhos pertencentes a outro usuário.

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::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs