IWindowForBindingUI

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 IWindowForBindingUI 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 IWindowForBindingUI to display information in the client's user interface. Note that the URL moniker will not request IWindowForBindingUI 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.

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

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.