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 quais trabalhos incluir 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 Meaning
BG_JOB_ENUM_ALL_USERS
Inclui todos os trabalhos na fila de transferência , aqueles pertencentes ao usuário e aqueles de propriedade de 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. Libere ppEnumJobs quando terminar.

Valor de retorno

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

Código de retorno Description
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.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP
Servidor mínimo compatível Windows Server 2003
da Plataforma de Destino Windows
Header bits.h
Library Bits.lib
de DLL QmgrPrxy.dll

Consulte também

IBackgroundCopyJob::EnumFiles

IBackgroundCopyManager::GetJob

IEnumBackgroundCopyJobs