Share via


IBackgroundCopyQMgr::CreateGroup-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 CreateGroup-Methode , um eine neue Gruppe zu erstellen und der Downloadwarteschlange hinzuzufügen.

Syntax

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

Parameter

[in] guidGroupID

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 erstellt.
E_INVALIDARG
Mit dieser GUID ist bereits eine Gruppe vorhanden.

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