IBackgroundCopyQMgr::GetGroup-Methode (qmgr.h)

[IBackgroundCopyQMgr steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die BITS-Schnittstellen.]

Verwenden Sie die GetGroup-Methode , um eine Gruppe aus der Downloadwarteschlange abzurufen. Der aktuelle Benutzer kann nur Gruppen abrufen, die er besitzt. Wenn der Benutzer über Administratorrechte verfügt, kann der Benutzer eine beliebige Gruppe aus der Downloadwarteschlange abrufen. Durch das Abrufen einer Gruppe aus der Warteschlange wird der Besitz der Gruppe an den aktuellen Benutzer übertragen.

Syntax

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

Die Parameter

[in] groupID

GUID, die die Gruppe in der Downloadwarteschlange eindeutig identifiziert.

[out] ppGroup

Zeiger auf einen IBackgroundCopyGroup-Schnittstellenzeiger . Verwenden Sie diese Schnittstelle, um die Gruppe zu verwalten. Fügen Sie beispielsweise der Gruppe einen Auftrag hinzu, und legen Sie die Eigenschaften der Gruppe fest.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.

Anforderungen

Siehe auch

IBackgroundCopyQMgr