CAsyncMonikerFile::CreateBindStatusCallback

virtual IUnknown* CreateBindStatusCallback( IUnknown* pUnkControlling );

Return Value

If pUnkControlling is not NULL, the function returns a pointer to the inner IUnknown on a new COM object supporting IBindStatusCallback. If pUnkControlling is NULL, the function returns a pointer to an IUnknown on a new COM object supporting IBindStatusCallback.

Parameters

pUnkControlling

A pointer to the controlling unknown (the outer IUnknown) or NULL if aggregation is not being used.

Remarks

CAsyncMonikerFile requires a COM object that implements IBindStatusCallback. MFC implements such an object, and it is aggregatable. You can override CreateBindStatusCallback to return your own COM object. Your COM object can aggregate MFC’s implementation by calling CreateBindStatusCallback with the controlling unknown of your COM object. COM objects implemented using CCmdTarget's COM support can retrieve the controlling unknown using CCmdTarget::GetControllingUnknown.

Alternately, your COM object can delegate to MFC's implementation by calling CreateBindStatusCallback( NULL ).

Open calls CreateBindStatusCallback.

For details about the IBindStatusCallback interface, described in the Platform SDK. For more about asynchronous binding, see How Asynchronous Binding and Storage Work in the Platform SDK. For a discussion of aggregation, see Aggregation in the Platform SDK.

CAsyncMonikerFile OverviewClass MembersHierarchy Chart