CShellDispatch Class Reference

#include <CShellDispatch.h>

Inheritance diagram for CShellDispatch:

Collaboration diagram for CShellDispatch:

Public Member Functions
	CShellDispatch ()
	~CShellDispatch ()
HRESULT	Initialize ()
virtual HRESULT STDMETHODCALLTYPE	get_Application (IDispatch **ppid)
virtual HRESULT STDMETHODCALLTYPE	get_Parent (IDispatch **ppid)
virtual HRESULT STDMETHODCALLTYPE	NameSpace (VARIANT vDir, Folder **ppsdf)
virtual HRESULT STDMETHODCALLTYPE	BrowseForFolder (LONG Hwnd, BSTR Title, LONG Options, VARIANT RootFolder, Folder **ppsdf)
virtual HRESULT STDMETHODCALLTYPE	Windows (IDispatch **ppid)
virtual HRESULT STDMETHODCALLTYPE	Open (VARIANT vDir)
virtual HRESULT STDMETHODCALLTYPE	Explore (VARIANT vDir)
virtual HRESULT STDMETHODCALLTYPE	MinimizeAll ()
virtual HRESULT STDMETHODCALLTYPE	UndoMinimizeALL ()
virtual HRESULT STDMETHODCALLTYPE	FileRun ()
virtual HRESULT STDMETHODCALLTYPE	CascadeWindows ()
virtual HRESULT STDMETHODCALLTYPE	TileVertically ()
virtual HRESULT STDMETHODCALLTYPE	TileHorizontally ()
virtual HRESULT STDMETHODCALLTYPE	ShutdownWindows ()
virtual HRESULT STDMETHODCALLTYPE	Suspend ()
virtual HRESULT STDMETHODCALLTYPE	EjectPC ()
virtual HRESULT STDMETHODCALLTYPE	SetTime ()
virtual HRESULT STDMETHODCALLTYPE	TrayProperties ()
virtual HRESULT STDMETHODCALLTYPE	Help ()
virtual HRESULT STDMETHODCALLTYPE	FindFiles ()
virtual HRESULT STDMETHODCALLTYPE	FindComputer ()
virtual HRESULT STDMETHODCALLTYPE	RefreshMenu ()
virtual HRESULT STDMETHODCALLTYPE	ControlPanelItem (BSTR szDir)
virtual HRESULT STDMETHODCALLTYPE	IsRestricted (BSTR group, BSTR restriction, LONG *value)
virtual HRESULT STDMETHODCALLTYPE	ShellExecute (BSTR file, VARIANT args, VARIANT dir, VARIANT op, VARIANT show)
virtual HRESULT STDMETHODCALLTYPE	FindPrinter (BSTR name, BSTR location, BSTR model)
virtual HRESULT STDMETHODCALLTYPE	GetSystemInformation (BSTR name, VARIANT *ret)
virtual HRESULT STDMETHODCALLTYPE	ServiceStart (BSTR service, VARIANT persistent, VARIANT *ret)
virtual HRESULT STDMETHODCALLTYPE	ServiceStop (BSTR service, VARIANT persistent, VARIANT *ret)
virtual HRESULT STDMETHODCALLTYPE	IsServiceRunning (BSTR service, VARIANT *running)
virtual HRESULT STDMETHODCALLTYPE	CanStartStopService (BSTR service, VARIANT *ret)
virtual HRESULT STDMETHODCALLTYPE	ShowBrowserBar (BSTR clsid, VARIANT show, VARIANT *ret)
virtual HRESULT STDMETHODCALLTYPE	AddToRecent (VARIANT file, BSTR category)
virtual HRESULT STDMETHODCALLTYPE	WindowsSecurity ()
virtual HRESULT STDMETHODCALLTYPE	ToggleDesktop ()
virtual HRESULT STDMETHODCALLTYPE	ExplorerPolicy (BSTR policy, VARIANT *value)
virtual HRESULT STDMETHODCALLTYPE	GetSetting (LONG setting, VARIANT_BOOL *result)
virtual HRESULT STDMETHODCALLTYPE	GetInterfaceSafetyOptions (REFIID riid, DWORD *pdwSupportedOptions, DWORD *pdwEnabledOptions)
virtual HRESULT STDMETHODCALLTYPE	SetInterfaceSafetyOptions (REFIID riid, DWORD dwOptionSetMask, DWORD dwEnabledOptions)
virtual HRESULT STDMETHODCALLTYPE	SetSite (IUnknown *pUnkSite)
virtual HRESULT STDMETHODCALLTYPE	GetSite (REFIID riid, PVOID *ppvSite)
Public Member Functions inherited from ATL::CComObjectRootEx< CComMultiThreadModelNoCS >
	~CComObjectRootEx ()
ULONG	InternalAddRef ()
ULONG	InternalRelease ()
void	Lock ()
void	Unlock ()
HRESULT	_AtlInitialConstruct ()
Public Member Functions inherited from ATL::CComObjectRootBase
	CComObjectRootBase ()
	~CComObjectRootBase ()
void	SetVoid (void *)
HRESULT	_AtlFinalConstruct ()
HRESULT	FinalConstruct ()
void	InternalFinalConstructAddRef ()
void	InternalFinalConstructRelease ()
void	FinalRelease ()
HRESULT	GetInterfaceSafetyOptions ([in] REFIID riid, [out] DWORD *pdwSupportedOptions, [out] DWORD *pdwEnabledOptions)
HRESULT	SetInterfaceSafetyOptions ([in] REFIID riid, [in] DWORD dwOptionSetMask, [in] DWORD dwEnabledOptions)
Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)
ULONG	AddRef ()
ULONG	Release ()
HRESULT	SetSite ([in] IUnknown *pUnkSite)
HRESULT	GetSite ([in] REFIID riid, [out, iid_is(riid)] PVOID *ppvSite)

Additional Inherited Members
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN
Public Types inherited from IObjectWithSite
typedef IObjectWithSite *	LPOBJECTWITHSITE
Static Public Member Functions inherited from ATL::CComObjectRootBase
static void WINAPI	ObjectMain (bool)
static const struct _ATL_CATMAP_ENTRY *	GetCategoryMap ()
static HRESULT WINAPI	InternalQueryInterface (void *pThis, const _ATL_INTMAP_ENTRY *pEntries, REFIID iid, void **ppvObject)
Public Attributes inherited from ATL::CComObjectRootBase
LONG	m_dwRef

Detailed Description

Definition at line 13 of file CShellDispatch.h.

Constructor & Destructor Documentation

CShellDispatch()

CShellDispatch::CShellDispatch

(

)

Definition at line 15 of file CShellDispatch.cpp.

{
}

~CShellDispatch()

CShellDispatch::~CShellDispatch

(

)

Definition at line 19 of file CShellDispatch.cpp.

{
}

Member Function Documentation

AddToRecent()

HRESULT STDMETHODCALLTYPE CShellDispatch::AddToRecent ( VARIANT  file, BSTR  category  )

virtual

Definition at line 357 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s, %ls)\n", this, wine_dbgstr_variant(&file), category);
    return E_NOTIMPL;
}

BrowseForFolder()

HRESULT STDMETHODCALLTYPE CShellDispatch::BrowseForFolder ( LONG  Hwnd, BSTR  Title, LONG  Options, VARIANT  RootFolder, Folder **  ppsdf  )

virtual

Definition at line 97 of file CShellDispatch.cpp.

{
    TRACE("(%p, %lu, %ls, %lu, %s, %p)\n", this, Hwnd, Title, Options, debugstr_variant(&RootFolder), ppsdf);
 
    *ppsdf = NULL;
 
    if (!is_optional_argument(&RootFolder))
        FIXME("root folder is ignored\n");
 
    BROWSEINFOW bi = { 0 };
    bi.hwndOwner = reinterpret_cast<HWND>(LongToHandle(Hwnd));
    bi.lpszTitle = Title;
    bi.ulFlags = Options;
 
    CComHeapPtr<ITEMIDLIST> selection;
    selection.Attach(SHBrowseForFolderW(&bi));
    if (!selection)
        return S_FALSE;
 
    return ShellObjectCreatorInit<CFolder>(static_cast<LPITEMIDLIST>(selection), IID_PPV_ARG(Folder, ppsdf));
}

CanStartStopService()

HRESULT STDMETHODCALLTYPE CShellDispatch::CanStartStopService ( BSTR  service, VARIANT *  ret  )

virtual

Definition at line 343 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %p)\n", this, service, ret);
    return E_NOTIMPL;
}

CascadeWindows()

HRESULT STDMETHODCALLTYPE CShellDispatch::CascadeWindows ( )

virtual

Definition at line 158 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

ControlPanelItem()

HRESULT STDMETHODCALLTYPE CShellDispatch::ControlPanelItem ( BSTR  szDir )

virtual

Definition at line 230 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls)\n", this, szDir);
    return E_NOTIMPL;
}

EjectPC()

HRESULT STDMETHODCALLTYPE CShellDispatch::EjectPC ( )

virtual

Definition at line 188 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

Explore()

HRESULT STDMETHODCALLTYPE CShellDispatch::Explore ( VARIANT  vDir )

virtual

Definition at line 134 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s)\n", this, debugstr_variant(&vDir));
    return E_NOTIMPL;
}

ExplorerPolicy()

HRESULT STDMETHODCALLTYPE CShellDispatch::ExplorerPolicy ( BSTR  policy, VARIANT *  value  )

virtual

Definition at line 381 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %p)\n", this, policy, value);
    return E_NOTIMPL;
}

FileRun()

HRESULT STDMETHODCALLTYPE CShellDispatch::FileRun ( )

virtual

Definition at line 152 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

FindComputer()

HRESULT STDMETHODCALLTYPE CShellDispatch::FindComputer ( )

virtual

Definition at line 218 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

FindFiles()

HRESULT STDMETHODCALLTYPE CShellDispatch::FindFiles ( )

virtual

Definition at line 212 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

FindPrinter()

HRESULT STDMETHODCALLTYPE CShellDispatch::FindPrinter ( BSTR  name, BSTR  location, BSTR  model  )

virtual

Definition at line 275 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %ls, %ls)\n", this, name, location, model);
    return E_NOTIMPL;
}

get_Application()

HRESULT STDMETHODCALLTYPE CShellDispatch::get_Application ( IDispatch **  ppid )

virtual

Definition at line 29 of file CShellDispatch.cpp.

{
    TRACE("(%p, %p)\n", this, ppid);
 
    if (!ppid)
        return E_INVALIDARG;
 
    *ppid = this;
    AddRef();
 
    return S_OK;
}

get_Parent()

HRESULT STDMETHODCALLTYPE CShellDispatch::get_Parent ( IDispatch **  ppid )

virtual

Definition at line 42 of file CShellDispatch.cpp.

{
    TRACE("(%p, %p)\n", this, ppid);
 
    if (ppid)
    {
        *ppid = static_cast<IDispatch*>(this);
        AddRef();
    }
 
    return S_OK;
}

GetInterfaceSafetyOptions()

HRESULT STDMETHODCALLTYPE CShellDispatch::GetInterfaceSafetyOptions ( REFIID  riid, DWORD *  pdwSupportedOptions, DWORD *  pdwEnabledOptions  )

virtual

Implements IObjectSafety.

Definition at line 395 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s, %p, %p)\n", this, wine_dbgstr_guid(&riid), pdwSupportedOptions, pdwEnabledOptions);
    return E_NOTIMPL;
}

GetSetting()

HRESULT STDMETHODCALLTYPE CShellDispatch::GetSetting ( LONG  setting, VARIANT_BOOL *  result  )

virtual

Definition at line 387 of file CShellDispatch.cpp.

{
    TRACE("(%p, %lu, %p)\n", this, setting, result);
    return E_NOTIMPL;
}

GetSite()

HRESULT STDMETHODCALLTYPE CShellDispatch::GetSite ( REFIID  riid, PVOID *  ppvSite  )

virtual

Implements IObjectWithSite.

Definition at line 415 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s, %p)\n", this, wine_dbgstr_guid(&riid), ppvSite);
    return E_NOTIMPL;
}

GetSystemInformation()

HRESULT STDMETHODCALLTYPE CShellDispatch::GetSystemInformation ( BSTR  name, VARIANT *  ret  )

virtual

Definition at line 281 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %p)\n", this, name, ret);
    return E_NOTIMPL;
}

Help()

HRESULT STDMETHODCALLTYPE CShellDispatch::Help ( )

virtual

Definition at line 206 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

Initialize()

HRESULT CShellDispatch::Initialize

(

)

Definition at line 23 of file CShellDispatch.cpp.

{
    return S_OK;
}

IsRestricted()

HRESULT STDMETHODCALLTYPE CShellDispatch::IsRestricted ( BSTR  group, BSTR  restriction, LONG *  value  )

virtual

Definition at line 238 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %ls, %p)\n", this, group, restriction, value);
    return E_NOTIMPL;
}

IsServiceRunning()

HRESULT STDMETHODCALLTYPE CShellDispatch::IsServiceRunning ( BSTR  service, VARIANT *  running  )

virtual

Definition at line 299 of file CShellDispatch.cpp.

{
    SERVICE_STATUS_PROCESS status;
    SC_HANDLE scm, service;
    DWORD dummy;
 
    TRACE("(%s, %p)\n", debugstr_w(name), running);
 
    V_VT(running) = VT_BOOL;
    V_BOOL(running) = VARIANT_FALSE;
 
    scm = OpenSCManagerW(NULL, NULL, SC_MANAGER_CONNECT);
    if (!scm)
    {
        ERR("failed to connect to service manager\n");
        return S_OK;
    }
 
    service = OpenServiceW(scm, name, SERVICE_QUERY_STATUS);
    if (!service)
    {
        ERR("Failed to open service %s (%u)\n", debugstr_w(name), GetLastError());
        CloseServiceHandle(scm);
        return S_OK;
    }
 
    if (!QueryServiceStatusEx(service, SC_STATUS_PROCESS_INFO, (BYTE *)&status,
                              sizeof(SERVICE_STATUS_PROCESS), &dummy))
    {
        TRACE("failed to query service status (%u)\n", GetLastError());
        CloseServiceHandle(service);
        CloseServiceHandle(scm);
        return S_OK;
    }
 
    if (status.dwCurrentState == SERVICE_RUNNING)
        V_BOOL(running) = VARIANT_TRUE;
 
    CloseServiceHandle(service);
    CloseServiceHandle(scm);
 
    return S_OK;
}

MinimizeAll()

HRESULT STDMETHODCALLTYPE CShellDispatch::MinimizeAll ( )

virtual

Definition at line 140 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

NameSpace()

HRESULT STDMETHODCALLTYPE CShellDispatch::NameSpace ( VARIANT  vDir, Folder **  ppsdf  )

virtual

Definition at line 69 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s, %p)\n", this, debugstr_variant(&vDir), ppsdf);
    if (!ppsdf)
        return E_POINTER;
    *ppsdf = NULL;
    HRESULT hr;
 
    if (V_VT(&vDir) == VT_I2)
    {
        hr = VariantChangeType(&vDir, &vDir, 0, VT_I4);
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
    }
 
    CComHeapPtr<ITEMIDLIST> idlist;
    hr = VariantToIdlist(&vDir, &idlist);
    if (!SUCCEEDED(hr) || !idlist)
        return S_FALSE;
 
    return ShellObjectCreatorInit<CFolder>(static_cast<LPITEMIDLIST>(idlist), IID_PPV_ARG(Folder, ppsdf));
}

Open()

HRESULT STDMETHODCALLTYPE CShellDispatch::Open ( VARIANT  vDir )

virtual

Definition at line 128 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s)\n", this, debugstr_variant(&vDir));
    return E_NOTIMPL;
}

RefreshMenu()

HRESULT STDMETHODCALLTYPE CShellDispatch::RefreshMenu ( )

virtual

Definition at line 224 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

ServiceStart()

HRESULT STDMETHODCALLTYPE CShellDispatch::ServiceStart ( BSTR  service, VARIANT  persistent, VARIANT *  ret  )

virtual

Definition at line 287 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %s, %p)\n", this, service, wine_dbgstr_variant(&persistent), ret);
    return E_NOTIMPL;
}

ServiceStop()

HRESULT STDMETHODCALLTYPE CShellDispatch::ServiceStop ( BSTR  service, VARIANT  persistent, VARIANT *  ret  )

virtual

Definition at line 293 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %s, %p)\n", this, service, wine_dbgstr_variant(&persistent), ret);
    return E_NOTIMPL;
}

SetInterfaceSafetyOptions()

HRESULT STDMETHODCALLTYPE CShellDispatch::SetInterfaceSafetyOptions ( REFIID  riid, DWORD  dwOptionSetMask, DWORD  dwEnabledOptions  )

virtual

Implements IObjectSafety.

Definition at line 401 of file CShellDispatch.cpp.

{
    TRACE("(%p, %s, %lu, %lu)\n", this, wine_dbgstr_guid(&riid), dwOptionSetMask, dwEnabledOptions);
    return E_NOTIMPL;
}

SetSite()

HRESULT STDMETHODCALLTYPE CShellDispatch::SetSite ( IUnknown *  pUnkSite )

virtual

Implements IObjectWithSite.

Definition at line 409 of file CShellDispatch.cpp.

{
    TRACE("(%p, %p)\n", this, pUnkSite);
    return E_NOTIMPL;
}

SetTime()

HRESULT STDMETHODCALLTYPE CShellDispatch::SetTime ( )

virtual

Definition at line 194 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

ShellExecute()

HRESULT STDMETHODCALLTYPE CShellDispatch::ShellExecute ( BSTR  file, VARIANT  args, VARIANT  dir, VARIANT  op, VARIANT  show  )

virtual

Definition at line 244 of file CShellDispatch.cpp.

{
    CComVariant args_str, dir_str, op_str, show_int;
    WCHAR *args = NULL, *dir = NULL, *op = NULL;
    INT show = 0;
    HINSTANCE ret;
 
    TRACE("(%s, %s, %s, %s, %s)\n", debugstr_w(file), debugstr_variant(&v_args),
            debugstr_variant(&v_dir), debugstr_variant(&v_op), debugstr_variant(&v_show));
 
    args_str.ChangeType(VT_BSTR, &v_args);
    if (V_VT(&args_str) == VT_BSTR)
        args = V_BSTR(&args_str);
 
    dir_str.ChangeType(VT_BSTR, &v_dir);
    if (V_VT(&dir_str) == VT_BSTR)
        dir = V_BSTR(&dir_str);
 
    op_str.ChangeType(VT_BSTR, &v_op);
    if (V_VT(&op_str) == VT_BSTR)
        op = V_BSTR(&op_str);
 
    show_int.ChangeType(VT_I4, &v_show);
    if (V_VT(&show_int) == VT_I4)
        show = V_I4(&show_int);
 
    ret = ShellExecuteW(NULL, op, file, args, dir, show);
 
    return (ULONG_PTR)ret > 32 ? S_OK : S_FALSE;
}

ShowBrowserBar()

HRESULT STDMETHODCALLTYPE CShellDispatch::ShowBrowserBar ( BSTR  clsid, VARIANT  show, VARIANT *  ret  )

virtual

Definition at line 349 of file CShellDispatch.cpp.

{
    TRACE("(%p, %ls, %s, %p)\n", this, clsid, wine_dbgstr_variant(&show), ret);
    return E_NOTIMPL;
}

ShutdownWindows()

HRESULT STDMETHODCALLTYPE CShellDispatch::ShutdownWindows ( )

virtual

Definition at line 176 of file CShellDispatch.cpp.

{
    ExitWindowsDialog(NULL);
    return S_OK;
}

Suspend()

HRESULT STDMETHODCALLTYPE CShellDispatch::Suspend ( )

virtual

Definition at line 182 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

TileHorizontally()

HRESULT STDMETHODCALLTYPE CShellDispatch::TileHorizontally ( )

virtual

Definition at line 170 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

TileVertically()

HRESULT STDMETHODCALLTYPE CShellDispatch::TileVertically ( )

virtual

Definition at line 164 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

ToggleDesktop()

HRESULT STDMETHODCALLTYPE CShellDispatch::ToggleDesktop ( )

virtual

Definition at line 371 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
 
    HWND hTrayWnd = FindWindowW(L"Shell_TrayWnd", NULL);
    PostMessageW(hTrayWnd, WM_COMMAND, TRAYCMD_TOGGLE_DESKTOP, 0);
 
    return S_OK;
}

TrayProperties()

HRESULT STDMETHODCALLTYPE CShellDispatch::TrayProperties ( )

virtual

Definition at line 200 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

UndoMinimizeALL()

HRESULT STDMETHODCALLTYPE CShellDispatch::UndoMinimizeALL ( )

virtual

Definition at line 146 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

Windows()

HRESULT STDMETHODCALLTYPE CShellDispatch::Windows ( IDispatch **  ppid )

virtual

Definition at line 119 of file CShellDispatch.cpp.

{
    TRACE("(%p, %p)\n", this, ppid);
 
    *ppid = NULL;
 
    return E_NOTIMPL;
}

WindowsSecurity()

HRESULT STDMETHODCALLTYPE CShellDispatch::WindowsSecurity ( )

virtual

Definition at line 365 of file CShellDispatch.cpp.

{
    TRACE("(%p)\n", this);
    return E_NOTIMPL;
}

---

The documentation for this class was generated from the following files:

• dll/win32/shell32/CShellDispatch.h
• dll/win32/shell32/CShellDispatch.cpp