IShellWindows interface (exdisp.h)

Provides access to the collection of open Shell windows.

Inheritance

The IShellWindows interface inherits from the IDispatch interface. IShellWindows also has these types of members:

Methods

The IShellWindows interface has these methods.

IShellWindows::_NewEnum Retrieves an enumerator for the collection of Shell windows.
IShellWindows::FindWindowSW Finds a window in the Shell windows collection and returns the window's handle and IDispatch interface.
IShellWindows::get_Count Gets the number of windows in the Shell windows collection.
IShellWindows::Item Returns the registered Shell window for a specified index.
IShellWindows::OnActivated Occurs when a Shell window's activation state changes.
IShellWindows::OnCreated Occurs when a new Shell window is created for a frame.
IShellWindows::OnNavigate Occurs when a Shell window is navigated to a new location.
IShellWindows::ProcessAttachDetach Deprecated. Always returns S_OK.
IShellWindows::Register Registers an open window as a Shell window; the window is specified by handle.
IShellWindows::RegisterPending Registers a pending window as a Shell window; the window is specified by an absolute PIDL.
IShellWindows::Revoke Revokes a Shell window's registration and removes the window from the Shell windows collection.

Remarks

A Shell window is a window that has been registered by calling IShellWindows::Register or IShellWindows::RegisterPending. Upon registration, the specified window is added to the collection of Shell windows, and granted a cookie that uniquely identifies the window within the collection. A window can be un-registered by calling IShellWindows::Revoke.

The Shell windows collection includes file explorer windows and web browser windows Internet Explorer and 3rd-party web browsers). Normally each Shell window implements IDispatch; IShellWindows::Item and IShellWindows::FindWindowSW provide ways to access a Shell window's IDispatch interface. For more information, see Dispatch Interface and Automation Functions.

IID	IID_IShellWindows (85CB6900-4D95-11CF-960C-0080C7F4EE85)
CLSID	CLSID_ShellWindows (9BA05972-F6A8-11CF-A442-00A0C90A8F39)

 

The following example shows how to retrieve an IShellWindows instance.

#include "exdisp.h"
                
...

IShellWindows *psw;
HRESULT hr;

hr = CoInitialize(NULL);
if (SUCCEEDED(hr))
{
    hr = CoCreateInstance(
        CLSID_ShellWindows,
        NULL,
        CLSCTX_ALL,
        IID_IShellWindows,
        (void**)&psw
    );
    
    if (SUCCEEDED(hr))
    {
        // Use the IShellWindows instance...
        
        psw->Release();
    }
}

Requirements

Requirement	Value
Target Platform	Windows
Header	exdisp.h

See also

CoCreateInstance

CoInitialize

DShellWindowsEvents

IDispatch

ShellWindows