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
Called by the moniker repeatedly to indicate the current progress of this bind operation, typically at reasonable intervals during a lengthy operation.
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.
CAsyncMonikerFile Overview | Class Members | Hierarchy Chart