#include "precomp.h"
#include <browseui_undoc.h>

Include dependency graph for explorer.cpp:

Classes
class	CExplorerModule

Functions
static VOID	InitializeAtlModule (HINSTANCE hInstance, BOOL bInitialize)

static void	InitializeServerAdminUI ()

static BOOL	SetShellReadyEvent (IN LPCWSTR lpEventName)

static VOID	HideMinimizedWindows (IN BOOL bHide)

static BOOL	IsExplorerSystemShell ()

static INT	StartWithCommandLine (IN HINSTANCE hInstance)

static INT	StartWithDesktop (IN HINSTANCE hInstance)

INT WINAPI	_tWinMain (IN HINSTANCE hInstance, IN HINSTANCE hPrevInstance, IN LPTSTR lpCmdLine, IN INT nCmdShow)

Variables
HINSTANCE	hExplorerInstance

HANDLE	hProcessHeap

HKEY	hkExplorer = NULL

BOOL	bExplorerIsShell = FALSE

CExplorerModule	gModule

CAtlWinModule	gWinModule

Function Documentation

◆ _tWinMain()

INT WINAPI _tWinMain	(	IN HINSTANCE	hInstance,
		IN HINSTANCE	hPrevInstance,
		IN LPTSTR	lpCmdLine,
		IN INT	nCmdShow
	)

Definition at line 261 of file explorer.cpp.

{
    /*
    * Set our shutdown parameters: we want to shutdown the very last,
    * but before any TaskMgr instance (which has a shutdown level of 1).
    */
    SetProcessShutdownParameters(2, 0);
 
    InitRSHELL();
 
    TRACE("Explorer starting... Command line: %S\n", lpCmdLine);
 
#if !WIN7_COMPAT_MODE
    bExplorerIsShell = (GetShellWindow() == NULL) && IsExplorerSystemShell();
 
    if (!bExplorerIsShell)
    {
        return StartWithCommandLine(hInstance);
    }
#else
    bExplorerIsShell = IsExplorerSystemShell();
#endif
 
    return StartWithDesktop(hInstance);
}

◆ HideMinimizedWindows()

static VOID HideMinimizedWindows ( IN BOOL bHide )

static

Definition at line 96 of file explorer.cpp.

{
    MINIMIZEDMETRICS mm;
 
    mm.cbSize = sizeof(mm);
    if (!SystemParametersInfoW(SPI_GETMINIMIZEDMETRICS, sizeof(mm), &mm, 0))
    {
        ERR("SystemParametersInfoW failed with %lu\n", GetLastError());
        return;
    }
    if (bHide)
        mm.iArrange |= ARW_HIDE;
    else
        mm.iArrange &= ~ARW_HIDE;
    if (!SystemParametersInfoW(SPI_SETMINIMIZEDMETRICS, sizeof(mm), &mm, 0))
        ERR("SystemParametersInfoW failed with %lu\n", GetLastError());
}

Referenced by StartWithDesktop().

◆ InitializeAtlModule()

static VOID InitializeAtlModule	(	HINSTANCE	hInstance,
		BOOL	bInitialize
	)

static

Definition at line 40 of file explorer.cpp.

{
    if (bInitialize)
    {
        gModule.Init(ObjectMap, hInstance, NULL);
    }
    else
    {
        gModule.Term();
    }
}

Referenced by StartWithDesktop().

◆ InitializeServerAdminUI()

static void InitializeServerAdminUI ( )

static

Definition at line 53 of file explorer.cpp.

{
    HKEY hKey = SHGetShellKey(SHKEY_Root_HKCU | SHKEY_Key_Explorer, L"Advanced", TRUE);
    if (!hKey)
        return;
 
    DWORD value, size = sizeof(value), type;
    DWORD error = SHGetValueW(hKey, NULL, L"ServerAdminUI", &type, &value, &size);
    if (error || type != REG_DWORD || size != sizeof(value))
    {
        // The value doesn't exist or is invalid, calculate and apply a default value
        value = IsOS(OS_ANYSERVER) && IsUserAnAdmin();
        SHSetValueW(hKey, NULL, L"ServerAdminUI", REG_DWORD, &value, sizeof(value));
        if (value)
        {
            // TODO: Apply registry tweaks with RegInstallW; RegServerAdmin in the REGINST resource in shell32.
            #if !ROSPOLICY_SHELL_NODEFKEYBOARDCUES
            SystemParametersInfo(SPI_SETKEYBOARDCUES, 0, IntToPtr(TRUE), SPIF_SENDCHANGE | SPIF_UPDATEINIFILE);
            #endif
        }
    }
    RegCloseKey(hKey);
}

Referenced by StartWithDesktop().

◆ IsExplorerSystemShell()

static BOOL IsExplorerSystemShell ( )

static

Definition at line 116 of file explorer.cpp.

{
    BOOL bIsSystemShell = TRUE; // Assume we are the system shell by default.
    WCHAR szPath[MAX_PATH];
 
    if (!GetModuleFileNameW(NULL, szPath, _countof(szPath)))
        return FALSE;
 
    LPWSTR szExplorer = PathFindFileNameW(szPath);
 
    HKEY hKeyWinlogon;
    if (RegOpenKeyExW(HKEY_LOCAL_MACHINE,
                      L"Software\\Microsoft\\Windows NT\\CurrentVersion\\Winlogon",
                      0, KEY_READ, &hKeyWinlogon) == ERROR_SUCCESS)
    {
        LSTATUS Status;
        DWORD dwType;
        WCHAR szShell[MAX_PATH];
        DWORD cbShell = sizeof(szShell);
 
        // TODO: Add support for paths longer than MAX_PATH
        Status = RegQueryValueExW(hKeyWinlogon, L"Shell", 0, &dwType, (LPBYTE)szShell, &cbShell);
        if (Status == ERROR_SUCCESS)
        {
            if ((dwType != REG_SZ && dwType != REG_EXPAND_SZ) || !StrStrIW(szShell, szExplorer))
                bIsSystemShell = FALSE;
        }
 
        RegCloseKey(hKeyWinlogon);
    }
 
    return bIsSystemShell;
}

Referenced by _tWinMain().

◆ SetShellReadyEvent()

static BOOL SetShellReadyEvent ( IN LPCWSTR lpEventName )

static

Definition at line 79 of file explorer.cpp.

{
    HANDLE hEvent;
 
    hEvent = OpenEventW(EVENT_MODIFY_STATE, FALSE, lpEventName);
    if (hEvent != NULL)
    {
        SetEvent(hEvent);
 
        CloseHandle(hEvent);
        return TRUE;
    }
 
    return FALSE;
}

Referenced by StartWithDesktop().

◆ StartWithCommandLine()

static INT StartWithCommandLine ( IN HINSTANCE hInstance )

static

Definition at line 152 of file explorer.cpp.

{
    BOOL b = FALSE;
    EXPLORER_CMDLINE_PARSE_RESULTS parseResults = { 0 };
 
    if (SHExplorerParseCmdLine(&parseResults))
        b = SHCreateFromDesktop(&parseResults);
 
    if (parseResults.strPath)
        SHFree(parseResults.strPath);
 
    if (parseResults.pidlPath)
        ILFree(parseResults.pidlPath);
 
    if (parseResults.pidlRoot)
        ILFree(parseResults.pidlRoot);
 
    return b;
}

Referenced by _tWinMain().

◆ StartWithDesktop()

static INT StartWithDesktop ( IN HINSTANCE hInstance )

static

Definition at line 174 of file explorer.cpp.

{
    InitializeAtlModule(hInstance, TRUE);
 
    if (RegOpenKeyW(HKEY_CURRENT_USER,
        L"Software\\Microsoft\\Windows\\CurrentVersion\\Explorer",
        &hkExplorer) != ERROR_SUCCESS)
    {
        WCHAR Message[256];
        LoadStringW(hInstance, IDS_STARTUP_ERROR, Message, _countof(Message));
        MessageBox(NULL, Message, NULL, MB_ICONERROR);
        return 1;
    }
 
    hExplorerInstance = hInstance;
    hProcessHeap = GetProcessHeap();
 
    g_TaskbarSettings.Load();
 
    InitCommonControls();
    OleInitialize(NULL);
 
#if !WIN7_COMPAT_MODE
    /* Initialize shell dde support */
    _ShellDDEInit(TRUE);
#endif
 
    /* Initialize shell icons */
    FileIconInit(TRUE);
 
    /* Initialize CLSID_ShellWindows class */
    _WinList_Init();
 
    InitializeServerAdminUI();
 
    CComPtr<ITrayWindow> Tray;
    CreateTrayWindow(&Tray);
 
#if !WIN7_DEBUG_MODE
    /* This not only hides the minimized window captions in the bottom
    left screen corner, but is also needed in order to receive
    HSHELL_* notification messages (which are required for taskbar
    buttons to work right) */
    HideMinimizedWindows(TRUE);
 
    ProcessRunOnceItems(); // Must be executed before the desktop is created
 
    HANDLE hShellDesktop = NULL;
    if (Tray != NULL)
        hShellDesktop = DesktopCreateWindow(Tray);
 
    /* WinXP: Notify msgina to hide the welcome screen */
    if (!SetShellReadyEvent(L"msgina: ShellReadyEvent"))
        SetShellReadyEvent(L"Global\\msgina: ShellReadyEvent");
 
    if (DoStartStartupItems(Tray))
    {
        ProcessStartupItems();
        DoFinishStartupItems();
    }
    ReleaseStartupMutex(); // For ProcessRunOnceItems
#endif
 
    if (Tray != NULL)
    {
        TrayMessageLoop(Tray);
#if !WIN7_DEBUG_MODE
        HideMinimizedWindows(FALSE);
#endif
    }
 
#if !WIN7_DEBUG_MODE
    if (hShellDesktop != NULL)
        DesktopDestroyShellWindow(hShellDesktop);
#endif
 
    OleUninitialize();
 
    RegCloseKey(hkExplorer);
    hkExplorer = NULL;
 
    InitializeAtlModule(hInstance, FALSE);
 
    return 0;
}