IBackgroundCopyGroup::GetProgress-Methode (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 GetProgress-Methode , um den Fortschritt des Downloads abzurufen.

Syntax

HRESULT GetProgress(
  [in]  DWORD dwFlags,
  [out] DWORD *pdwProgress
);

Parameter

[in] dwFlags

Art des abzurufenden Fortschritts. Geben Sie eines der folgenden Flags an.

Wert	Bedeutung
QM_PROGRESS_PERCENT_DONE	Gibt den Prozentsatz des vollständigen Downloads zurück.
QM_PROGRESS_SIZE_DONE	Gibt die Anzahl der heruntergeladenen Bytes zurück.
QM_PROGRESS_TIME_DONE	Wird nicht unterstützt.

[out] pdwProgress

Status des Downloads. Der Fortschritt stellt abhängig von dwFlags die Anzahl der heruntergeladenen Bytes oder den Prozentsatz des abgeschlossenen Downloads dar.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Der Fortschritt der Gruppe wurde erfolgreich abgerufen.
E_NOTIMPL	Sie können QM_PROGRESS_TIME_DONE für den dwFlags-Parameter nicht angeben.

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

IBackgroundCopyGroup