Share via


CAsyncMonikerFile::OnProgress

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

virtual void OnProgress(
   ULONG ulProgress,
   ULONG ulProgressMax,
   ULONG ulStatusCode,
   LPCTSTR szStatusText 
);

Parameters

  • ulProgress
    Indicates the current progress of the bind operation relative to the expected maximum indicated in ulProgressMax.

  • ulProgressMax
    Indicates the expected maximum value of ulProgress for the duration of calls to OnProgress for this operation.

  • ulStatusCode
    Provides additional information regarding the progress of the bind operation. Valid values are taken from the BINDSTATUS enumeration. See Remarks for possible values.

  • szStatusText
    Information about the current progress, depending on the value of ulStatusCode. See Remarks for possible values.

Remarks

Possible values for ulStatusCode (and the szStatusText for each value) are:

  • BINDSTATUS_FINDINGRESOURCE
    The bind operation is finding the resource that holds the object or storage being bound to. The szStatusText provides the display name of the resource being searched for (for example, "www.microsoft.com").

  • BINDSTATUS_CONNECTING
    The bind operation is connecting to the resource that holds the object or storage being bound to. The szStatusText provides the display name of the resource being connected to (for example, an IP address).

  • BINDSTATUS_SENDINGREQUEST
    The bind operation is requesting the object or storage being bound to. The szStatusText provides the display name of the object (for example, a file name).

  • BINDSTATUS_REDIRECTING
    The bind operation has been redirected to a different data location. The szStatusText provides the display name of the new data location.

  • BINDSTATUS_USINGCACHEDCOPY
    The bind operation is retrieving the requested object or storage from a cached copy. The szStatusText is NULL.

  • BINDSTATUS_BEGINDOWNLOADDATA
    The bind operation has begun receiving the object or storage being bound to. The szStatusText provides the display name of the data location.

  • BINDSTATUS_DOWNLOADINGDATA
    The bind operation continues to receive the object or storage being bound to. The szStatusText provides the display name of the data location.

  • BINDSTATUS_ENDDOWNLOADDATA
    The bind operation has finished receiving the object or storage being bound to. The szStatusText provides the display name of the data location.

  • BINDSTATUS_CLASSIDAVAILABLE
    An instance of the object being bound to is just about to be created. The szStatusText provides the CLSID of the new object in string format, allowing the client an opportunity to cancel the bind operation, if desired.

Requirements

Header: afxole.h

See Also

Reference

CAsyncMonikerFile Class

Hierarchy Chart

Other Resources

CAsyncMonikerFile Members