mirror of
https://github.com/reactos/reactos.git
synced 2024-07-01 10:20:03 +00:00
d41dec2e07
Add a basic IOpenControlPanel implementation that supports Vista canonical registry names. Implements `control.exe /name company.name [/page id]` and `IOpenControlPanel` handling of Vista-style canonical registry names. The documented `Microsoft.*` names don't work because they are simply not in our registry but "[Executable Control Panel Items](https://learn.microsoft.com/en-us/windows/win32/shell/how-to-register-an-executable-control-panel-item-registration-)" registered by 3rd-party ISVs will function correctly in control.exe and the COM API. Notes: - `IOpenControlPanel` is implemented in CControlPanelFolder.cpp because it is supposed to have tighter integration with that shell folder than it does in this PR. - `IOpenControlPanel` is also supposed to handle .cpl files with canonical names registered under [`Extended Properties`](https://learn.microsoft.com/en-us/windows/win32/shell/how-to-register-dll-control-panel-item-registration-#step-3) but the control panel folder does not implement `IShellFolder2::GetDetailsEx` yet, so it will have to wait. - These "Executable Control Panel Items" are also supposed to be displayed in the control panel itself but this PR does not address that. The `ITEMIDLIST` format for those needs investigation... - The Wow64 handling is perhaps not correct but it does not matter, `ShellExecuteEx` gets to deal with whatever is in the `...\shell\open\command` key. `CControlPanelFolder` would have to take more care when it starts reading those keys so it knows when to append "(32-bit)" to the display name. - `%s%s` because .cpl canonical names don't have the `::` prefix according to Geoff Chappell. - Always returns `CPVIEW_CLASSIC` because our `CControlPanelFolder` does not support the category view.
245 lines
8.7 KiB
C
245 lines
8.7 KiB
C
/*
|
|
* PROJECT: ReactOS System Control Panel
|
|
* LICENSE: GPL-2.0+ (https://spdx.org/licenses/GPL-2.0+)
|
|
* PURPOSE: ReactOS System Control Panel
|
|
* COPYRIGHT: Copyright 2004 Gero Kuehn (reactos.filter@gkware.com)
|
|
* Copyright 2008 Colin Finck (colin@reactos.org)
|
|
* Copyright 2014 Hermès Bélusca-Maïto (hermes.belusca-maito@reactos.org)
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
|
|
#define WIN32_NO_STATUS
|
|
#define COBJMACROS
|
|
|
|
|
|
#include <windef.h>
|
|
#include <winbase.h>
|
|
#include <winuser.h>
|
|
#include <winreg.h>
|
|
#include <shellapi.h>
|
|
#include <strsafe.h>
|
|
#include <objbase.h>
|
|
#include <shobjidl.h>
|
|
#include <shlguid.h>
|
|
|
|
#include "resource.h"
|
|
|
|
#define MAX_VALUE_NAME 16383
|
|
|
|
/*
|
|
* Macro for calling "rundll32.exe"
|
|
* According to MSDN, ShellExecute returns a value greater than 32
|
|
* if the operation was successful.
|
|
*/
|
|
#define RUNDLL(param) \
|
|
((INT_PTR)ShellExecuteW(NULL, L"open", L"rundll32.exe", (param), NULL, SW_SHOWDEFAULT) > 32)
|
|
|
|
VOID
|
|
WINAPI
|
|
Control_RunDLLW(HWND hWnd, HINSTANCE hInst, LPCWSTR cmd, DWORD nCmdShow);
|
|
|
|
static BOOL
|
|
IsSwitch(LPCWSTR Switch, LPCWSTR Arg)
|
|
{
|
|
if (*Arg == '/' || *Arg == '-')
|
|
{
|
|
return !lstrcmpiW(Arg+1, Switch);
|
|
}
|
|
return FALSE;
|
|
}
|
|
|
|
static HRESULT
|
|
OpenControlPanelItem(LPCWSTR Name, LPCWSTR Page)
|
|
{
|
|
HRESULT hr = CoInitialize(0);
|
|
if (SUCCEEDED(hr))
|
|
{
|
|
IOpenControlPanel *pOCP;
|
|
hr = CoCreateInstance(&CLSID_OpenControlPanel, NULL, CLSCTX_INPROC_SERVER,
|
|
&IID_IOpenControlPanel, (void**)&pOCP);
|
|
if (SUCCEEDED(hr))
|
|
{
|
|
hr = IOpenControlPanel_Open(pOCP, Name, Page, NULL);
|
|
IOpenControlPanel_Release(pOCP);
|
|
}
|
|
CoUninitialize();
|
|
}
|
|
return hr;
|
|
}
|
|
|
|
static INT
|
|
OpenShellFolder(LPWSTR lpFolderCLSID)
|
|
{
|
|
WCHAR szParameters[MAX_PATH];
|
|
|
|
/*
|
|
* Open a shell folder using "explorer.exe". The passed CLSIDs
|
|
* are all subfolders of the "Control Panel" shell folder.
|
|
*/
|
|
StringCbCopyW(szParameters, sizeof(szParameters), L"/n,::{20D04FE0-3AEA-1069-A2D8-08002B30309D}\\::{21EC2020-3AEA-1069-A2DD-08002B30309D}");
|
|
StringCbCatW(szParameters, sizeof(szParameters), lpFolderCLSID);
|
|
|
|
return (INT_PTR)ShellExecuteW(NULL,
|
|
L"open",
|
|
L"explorer.exe",
|
|
szParameters,
|
|
NULL,
|
|
SW_SHOWDEFAULT) > 32;
|
|
}
|
|
|
|
static INT
|
|
RunControlPanel(LPCWSTR lpCmd)
|
|
{
|
|
WCHAR szParameters[MAX_PATH];
|
|
StringCchCopyW(szParameters, ARRAYSIZE(szParameters), L"shell32.dll,Control_RunDLL ");
|
|
if (FAILED(StringCchCatW(szParameters, ARRAYSIZE(szParameters), lpCmd)))
|
|
return 0;
|
|
|
|
return RUNDLL(szParameters);
|
|
}
|
|
|
|
INT
|
|
WINAPI
|
|
wWinMain(HINSTANCE hInstance,
|
|
HINSTANCE hPrevInstance,
|
|
LPWSTR lpCmdLine,
|
|
INT nCmdShow)
|
|
{
|
|
HKEY hKey;
|
|
LPWSTR *argv;
|
|
int argc;
|
|
|
|
/* Show the control panel window if no argument or "panel" was passed */
|
|
if (*lpCmdLine == 0 || !_wcsicmp(lpCmdLine, L"panel"))
|
|
return OpenShellFolder(L"");
|
|
|
|
/* Map legacy control panels */
|
|
if (!_wcsicmp(lpCmdLine, L"sticpl.cpl")) lpCmdLine = (LPWSTR) L"scannercamera";
|
|
|
|
/* Check one of the built-in control panel handlers */
|
|
if (!_wcsicmp(lpCmdLine, L"admintools")) return OpenShellFolder(L"\\::{D20EA4E1-3957-11d2-A40B-0C5020524153}");
|
|
else if (!_wcsicmp(lpCmdLine, L"color")) return RunControlPanel(L"desk.cpl,,2");
|
|
else if (!_wcsicmp(lpCmdLine, L"date/time")) return RunControlPanel(L"timedate.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"desktop")) return RunControlPanel(L"desk.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"folders")) return RUNDLL(L"shell32.dll,Options_RunDLL");
|
|
else if (!_wcsicmp(lpCmdLine, L"fonts")) return OpenShellFolder(L"\\::{D20EA4E1-3957-11d2-A40B-0C5020524152}");
|
|
else if (!_wcsicmp(lpCmdLine, L"infrared")) return RunControlPanel(L"irprops.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"international")) return RunControlPanel(L"intl.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"keyboard")) return RunControlPanel(L"main.cpl @1");
|
|
else if (!_wcsicmp(lpCmdLine, L"mouse")) return RunControlPanel(L"main.cpl @0");
|
|
else if (!_wcsicmp(lpCmdLine, L"netconnections")) return OpenShellFolder(L"\\::{7007ACC7-3202-11D1-AAD2-00805FC1270E}");
|
|
else if (!_wcsicmp(lpCmdLine, L"netware")) return RunControlPanel(L"nwc.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"ports")) return RunControlPanel(L"sysdm.cpl,,1");
|
|
else if (!_wcsicmp(lpCmdLine, L"printers")) return OpenShellFolder(L"\\::{2227A280-3AEA-1069-A2DE-08002B30309D}");
|
|
else if (!_wcsicmp(lpCmdLine, L"scannercamera")) return OpenShellFolder(L"\\::{E211B736-43FD-11D1-9EFB-0000F8757FCD}");
|
|
else if (!_wcsicmp(lpCmdLine, L"schedtasks")) return OpenShellFolder(L"\\::{D6277990-4C6A-11CF-8D87-00AA0060F5BF}");
|
|
else if (!_wcsicmp(lpCmdLine, L"telephony")) return RunControlPanel(L"telephon.cpl");
|
|
else if (!_wcsicmp(lpCmdLine, L"userpasswords")) return RunControlPanel(L"nusrmgr.cpl"); /* Graphical User Account Manager */
|
|
else if (!_wcsicmp(lpCmdLine, L"userpasswords2")) return RUNDLL(L"netplwiz.dll,UsersRunDll"); /* Dialog based advanced User Account Manager */
|
|
|
|
/* https://learn.microsoft.com/en-us/windows/win32/shell/executing-control-panel-items#windows-vista-canonical-names */
|
|
argv = CommandLineToArgvW(lpCmdLine, &argc);
|
|
if (argv)
|
|
{
|
|
UINT argi = 0;
|
|
HRESULT hr = -1;
|
|
if (argc >= 2 && IsSwitch(L"name", argv[argi + 0]))
|
|
{
|
|
LPCWSTR pszPage = NULL;
|
|
if (argc >= 4 && IsSwitch(L"page", argv[argi + 2]))
|
|
{
|
|
pszPage = argv[argi + 3];
|
|
}
|
|
hr = OpenControlPanelItem(argv[argi + 1], pszPage);
|
|
}
|
|
LocalFree(argv);
|
|
if (hr != -1)
|
|
{
|
|
return SUCCEEDED(hr);
|
|
}
|
|
}
|
|
|
|
/* It is none of them, so look for a handler in the registry */
|
|
if (RegOpenKeyExW(HKEY_LOCAL_MACHINE,
|
|
L"Software\\Microsoft\\Windows\\CurrentVersion\\Control Panel\\Cpls",
|
|
0,
|
|
KEY_QUERY_VALUE,
|
|
&hKey) == ERROR_SUCCESS)
|
|
{
|
|
DWORD dwIndex;
|
|
|
|
for (dwIndex = 0; ; ++dwIndex)
|
|
{
|
|
DWORD dwDataSize;
|
|
DWORD dwValueSize = MAX_VALUE_NAME;
|
|
WCHAR szValueName[MAX_VALUE_NAME];
|
|
|
|
/* Get the value name and data size */
|
|
if (RegEnumValueW(hKey,
|
|
dwIndex,
|
|
szValueName,
|
|
&dwValueSize,
|
|
0,
|
|
NULL,
|
|
NULL,
|
|
&dwDataSize) != ERROR_SUCCESS)
|
|
{
|
|
break;
|
|
}
|
|
|
|
/* Check if the parameter is the value name */
|
|
if (!_wcsicmp(lpCmdLine, szValueName))
|
|
{
|
|
/*
|
|
* Allocate memory for the data plus two more characters,
|
|
* so we can quote the file name if required.
|
|
*/
|
|
LPWSTR pszData;
|
|
pszData = HeapAlloc(GetProcessHeap(),
|
|
0,
|
|
dwDataSize + 2 * sizeof(WCHAR));
|
|
++pszData;
|
|
|
|
/*
|
|
* This value is the one we are looking for, so get the data.
|
|
* It is the path to a .cpl file.
|
|
*/
|
|
if (RegQueryValueExW(hKey,
|
|
szValueName,
|
|
0,
|
|
NULL,
|
|
(LPBYTE)pszData,
|
|
&dwDataSize) == ERROR_SUCCESS)
|
|
{
|
|
INT nReturnValue;
|
|
|
|
/* Quote the file name if required */
|
|
if (*pszData != L'\"')
|
|
{
|
|
*(--pszData) = L'\"';
|
|
pszData[dwDataSize / sizeof(WCHAR)] = L'\"';
|
|
pszData[(dwDataSize / sizeof(WCHAR)) + 1] = 0;
|
|
}
|
|
|
|
nReturnValue = RunControlPanel(pszData);
|
|
HeapFree(GetProcessHeap(), 0, pszData);
|
|
RegCloseKey(hKey);
|
|
|
|
return nReturnValue;
|
|
}
|
|
|
|
HeapFree(GetProcessHeap(), 0, pszData);
|
|
}
|
|
}
|
|
|
|
RegCloseKey(hKey);
|
|
}
|
|
|
|
/*
|
|
* It's none of the known parameters, so interpret the parameter
|
|
* as the file name of a control panel applet.
|
|
*/
|
|
return RunControlPanel(lpCmdLine);
|
|
}
|