Compartilhar via


Método IBackgroundCopyQMgr::GetGroup (qmgr.h)

[IBackgroundCopyQMgr está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use as interfaces BITS.]

Use o método GetGroup para recuperar um grupo da fila de download. O usuário atual pode recuperar apenas os grupos que possui. Se o usuário tiver privilégios de Administrador, o usuário poderá recuperar qualquer grupo da fila de download. A recuperação de um grupo da fila transfere a propriedade do grupo para o usuário atual.

Sintaxe

HRESULT GetGroup(
  [in]  GUID                 groupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Parâmetros

[in] groupID

GUID que identifica exclusivamente o grupo na fila de download.

[out] ppGroup

Ponteiro para um ponteiro de interface IBackgroundCopyGroup . Use essa interface para gerenciar o grupo. Por exemplo, adicione um trabalho ao grupo e defina as propriedades do grupo.

Retornar valor

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

Código de retorno Descrição
S_OK
O grupo foi recuperado com êxito.
QM_E_ITEM_NOT_FOUND
Não foi possível localizar o grupo na fila de download.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho qmgr.h
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyQMgr