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

Artigo
02/28/2024

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

Compartilhar via