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

[IBackgroundCopyQMgr está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use las interfaces BITS.]

Use el método GetGroup para recuperar un grupo de la cola de descarga. El usuario actual solo puede recuperar los grupos que poseen. Si el usuario tiene privilegios de administrador, el usuario puede recuperar cualquier grupo de la cola de descarga. Al recuperar un grupo de la cola se transfiere la propiedad del grupo al usuario actual.

Sintaxis

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

Parámetros

[in] groupID

GUID que identifica de forma única el grupo en la cola de descarga.

[out] ppGroup

Puntero a un puntero de interfaz IBackgroundCopyGroup . Use esta interfaz para administrar el grupo. Por ejemplo, agregue un trabajo al grupo y establezca las propiedades del grupo.

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto	Descripción
S_OK	Recuperó correctamente el grupo.
QM_E_ITEM_NOT_FOUND	No se encontró el grupo en la cola de descarga.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Plataforma de destino	Windows
Encabezado	qmgr.h
Archivo DLL	QmgrPrxy.dll

Consulte también

IBackgroundCopyQMgr