IBindStatusCallback::OnProgressIBindStatusCallback::OnProgress*
*Contents  *Index  *Topic Contents
*Previous Topic: IBindStatusCallback::OnObjectAvailable
*Next Topic: IBindStatusCallback::OnStartBinding

IBindStatusCallback::OnProgress

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

Indicates the current progress of the bind operation.

ulProgress
Current progress of the bind operation relative to the expected maximum indicated in the ulProgressMax parameter.
ulProgressMax
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
Additional information regarding the progress of the bind operation. Valid values are taken from the BINDSTATUS enumeration and include:
BINDSTATUS_BEGINDOWNLOADCOMPONENTS The download operation has begun downloading code for COM components that will be installed before the object can be instantiated. The szStatusText parameter accompanying IBindStatusCallback::OnProgress provides the display name of the component being downloaded.
BINDSTATUS_INSTALLINGCOMPONENTS The download operation has downloaded code and is installing it. The szStatusText parameter accompanying IBindStatusCallback::OnProgress provides the display name of the component being installed.
BINDSTATUS_ENDDOWNLOADCOMPONENTS The download operation has finished downloading and installing all the necessary code. The szStatusText parameter accompanying IBindStatusCallback::OnProgress provides the display name of the newly installed component.
szStatusText
Textual information indicating 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.

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.

Notes to implementers

A client can return E_UNIMPL or S_OK if it is not interested in receiving this notification.

See also BINDSTATUS

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.