IBackgroundCopyGroup::GetProgress method

[IBackgroundCopyGroup is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the BITS interfaces.]

Use the GetProgress method to retrieve the progress of the download.

Syntax

HRESULT GetProgress(
  DWORD dwFlags,
  DWORD *pdwProgress
);

Parameters

dwFlags

Type of progress to retrieve. Specify one of the following flags.

Value Meaning
QM_PROGRESS_PERCENT_DONE
Returns the percent of the download that is complete.
QM_PROGRESS_SIZE_DONE
Returns the number of bytes downloaded.
QM_PROGRESS_TIME_DONE
Not supported.

pdwProgress

Progress of the download. The progress represents the number of bytes downloaded or the percent of the download that is complete, depending on dwFlags.

Return value

This method returns the following HRESULT values, as well as others.

Return code Description
S_OK
Successfully retrieved the group's progress.
E_NOTIMPL
You cannot specify QM_PROGRESS_TIME_DONE for the dwFlags parameter.

Requirements

   
Minimum supported client Windows XP
Minimum supported server Windows Server 2003
Target Platform Windows
Header qmgr.h
DLL QmgrPrxy.dll

See also

IBackgroundCopyGroup