Contents Previous Page Next Page
IWindow

During a bind operation, the moniker can obtain some additional bind information by calling the bind clientÆs IBindStatusCallback::GetBindInfo. In some cases, additional callback interfaces can be provided by the client requesting the bind operation to supply even more services to the moniker performing the bind. These additional interfaces are typically requested by the moniker calling IBindStatusCallback::QueryInterface for the interface desired. However, a moniker client can also provide additional interfaces through IServiceProvider.

In the case of URL monikers, the IWindow interface is an additional callback interface that the client can provide.

When to Implement

Clients of URL monikers implement this interface to allow the URL moniker to display information in the clientÆs user interface when necessary. This interface is usually implemented by OLE containers that also implement the IBindHost interface.

When to Use

The URL moniker uses IWindow to display information in the clientÆs user interface. Note that the URL moniker will not request IWindow from clients unless the bind context BIND_OPTS specify the grfFlags value of BIND_MAYBOTHERUSER. The bind context BIND_OPTS is set by calling IBindCtx::SetBindOptions.

Methods in Vtable Order

IUnknown Methods                          Description                                  
                                                                                       
QueryInterface                            
Returns pointers to supported interfaces.    
                                                                                       
AddRef                                    Increments the reference count.              
                                                                                       
Release                                   Decrements the reference count.              
                                                                                       

IWindow Methods                           Description                                  
                                                                                       
GetWindow                                 
Returns an HWND for displaying user interface 
                                          information.