Método IBackgroundCopyQMgr::CreateGroup (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 CreateGroup para criar um novo grupo e adicioná-lo à fila de download.

Sintaxe

HRESULT CreateGroup(
  [in]  GUID                 guidGroupID,
  [out] IBackgroundCopyGroup **ppGroup
);

Parâmetros

[in] guidGroupID

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 criado com êxito.
E_INVALIDARG	Já existe um grupo com esse GUID.

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