IBackgroundCopyQMgr::GetGroup-Methode (qmgr.h)
[IBackgroundCopyQMgr ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. 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 er 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
);
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 der Gruppe beispielsweise einen Auftrag hinzu, und legen Sie die Eigenschaften der Gruppe fest.
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Gruppe wurde erfolgreich abgerufen. |
|
Die Gruppe konnte in der Downloadwarteschlange nicht gefunden werden. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | qmgr.h |
| DLL | QmgrPrxy.dll |