IBackgroundCopyGroup-Schnittstelle (qmgr.h)
[IBackgroundCopyGroup 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 IBackgroundCopyGroup-Schnittstelle , um eine Gruppe zu verwalten. Eine Gruppe enthält Downloadaufträge. Fügen Sie der Gruppe beispielsweise einen Auftrag hinzu, legen Sie die Eigenschaften der Gruppe fest, und starten und beenden Sie die Gruppe in der Downloadwarteschlange.
Vererbung
Die IBackgroundCopyGroup-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyGroup verfügt auch über folgende Membertypen:
Methoden
Die IBackgroundCopyGroup-Schnittstelle verfügt über diese Methoden.
| IBackgroundCopyGroup::CancelGroup Verwenden Sie die CancelGroup-Methode, um die Gruppe aus der Warteschlange zu entfernen. Dateien, die vollständig heruntergeladen wurden, bevor diese Methode aufgerufen wird, stehen dem Client zur Verfügung. Sie können eine Gruppe jederzeit kündigen. Die Gruppe kann jedoch nicht wiederhergestellt werden, nachdem sie abgebrochen wurde. |
| IBackgroundCopyGroup::CreateJob Verwenden Sie die CreateJob-Methode, um der Gruppe einen neuen Auftrag hinzuzufügen. Eine Gruppe kann nur einen Auftrag enthalten. |
| IBackgroundCopyGroup::EnumJobs Verwenden Sie die EnumJobs-Methode, um eine Liste der Aufträge in der Gruppe abzurufen. Die Liste enthält nur einen Auftrag. |
| IBackgroundCopyGroup::get_GroupID Verwenden Sie die get_GroupID-Methode, um den Bezeichner der Gruppe abzurufen. |
| IBackgroundCopyGroup::get_Size Verwenden Sie die get_Size-Methode, um die Größe aller Dateien in der Gruppe abzurufen, die heruntergeladen werden sollen. |
| IBackgroundCopyGroup::GetJob Verwenden Sie die GetJob-Methode, um einen Auftrag aus der Gruppe abzurufen. |
| IBackgroundCopyGroup::GetProgress Verwenden Sie die GetProgress-Methode, um den Fortschritt des Downloads abzurufen. |
| IBackgroundCopyGroup::GetProp Verwenden Sie die GetProp-Methode, um einen Eigenschaftswert aus der Gruppe abzurufen. |
| IBackgroundCopyGroup::GetStatus Verwenden Sie die GetStatus-Methode, um den Status der Gruppe abzurufen. |
| IBackgroundCopyGroup::ResumeGroup Verwenden Sie die ResumeGroup-Methode, um eine Gruppe zu starten, die in der Downloadwarteschlange angehalten wurde. |
| IBackgroundCopyGroup::SetProp Verwenden Sie die SetProp-Methode, um den Eigenschaftswert für eine Group-Eigenschaft festzulegen. |
| IBackgroundCopyGroup::SuspendGroup Verwenden Sie die SuspendGroup-Methode, um eine Gruppe in der Downloadwarteschlange anzuhalten. Neue Gruppen, Fehlergruppen oder Gruppen, die den Download abgeschlossen haben, werden automatisch angehalten. |
| IBackgroundCopyGroup::SwitchToForeground Verwenden Sie die SwitchToForeground-Methode, um die Gruppe im Vordergrund und nicht im Hintergrund herunterzuladen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | qmgr.h |