IBindStatusCallback::OnProgress method

Indicates the progress of the bind operation.

Syntax

HRESULT OnProgress(
  [in] unsigned long ulProgress,
  [in] unsigned long ulProgressMax,
  [in] unsigned long ulStatusCode,
  [in] LPCWSTR       szStatusText
);

Parameters

  • ulProgress [in]
    An unsigned long integer that contains the current progress of the bind operation relative to the expected maximum that is indicated in the ulProgressMax parameter.

  • ulProgressMax [in]
    An unsigned long integer that contains the expected maximum value of the ulProgress parameter for the duration of calls to IBindStatusCallback::OnProgress for this bind operation. Note that this value might change across calls to this method. A value of zero means that the maximum value of ulProgress is unknown; for example, in the IMoniker::BindToStorage method when the data download size is unknown.

  • ulStatusCode [in]
    An unsigned long integer that Additional information regarding the progress of the bind operation. This can be any of the BINDSTATUS values.

  • szStatusText [in]
    The address of a string value that contains the textual information that indicates the current progress of the bind operation. The text reflects the BINDSTATUS value of the ulStatusCode parameter and is appropriate for display in the user interface of the client.

Return value

Returns S_OK if successful, or E_INVALIDARG if one or more parameters are invalid.

Remarks

The moniker calls this method repeatedly to indicate the current progress of the bind operation, typically, at reasonable intervals during a lengthy operation.

The client can use the progress notification to provide progress information to the user from the ulProgress, ulProgressMax, and szStatusText parameters, or to make programmatic decisions based on the ulStatusCode parameter.

Client applications that implement the IBindStatusCallback interface can return E_NOTIMPL or S_OK, if they don't have to receive this notification.

Windows Internet Explorer 8. If ulStatusCode is set to BINDSTATUS_64BIT_PROGRESS, then szStatusText contains a string representing the progress of the download as two 64-bit numbers (representing ulProgress and ulProgressMax) separated by a comma.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Product

Internet Explorer 4.0

DLL

Urlmon.dll

See also

IBindStatusCallback