IBackgroundCopyQMgr::GetGroup-Methode (qmgr.h)

Artikel
03/01/2024

[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
S_OK	Die Gruppe wurde erfolgreich abgerufen.
QM_E_ITEM_NOT_FOUND	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

Weitere Informationen

IBackgroundCopyQMgr

Share via