Shell Extension Handler support

- switched from CMake to MSBuild
- bumped version number to 0.2
- updated README

Author: mbcdev

.github/workflows/cmake.yml

@@ -0,0 +1,43 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: MSBuild
+
+on:
+  workflow_dispatch:
+
+env:
+  # Path to the solution file relative to the root of the project.
+  SOLUTION_FILE_PATH: RunAsTI.sln
+
+  # Configuration type to build.
+  # You can convert this to a build matrix if you need coverage of multiple configuration types.
+  # https://docs.github.com/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix
+  BUILD_CONFIGURATION: Release
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Add MSBuild to PATH
+      uses: microsoft/setup-msbuild@v1.0.2
+
+    - name: Build
+      working-directory: ${{env.GITHUB_WORKSPACE}}
+      # Add additional options to the MSBuild command line here (like platform or verbosity level).
+      # See https://docs.microsoft.com/visualstudio/msbuild/msbuild-command-line-reference
+      run: msbuild /p:Configuration=${{env.BUILD_CONFIGURATION}} ${{env.SOLUTION_FILE_PATH}}
+
+    - name: Upload
+      uses: actions/upload-artifact@v4
+      with:
+        name: assets
+        path: ${{github.workspace}}/x64/Release

.github/workflows/msbuild.yml

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 mbcdev
+Copyright (c) 2023-2024 mbcdev
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

CMakeLists.txt

@@ -1,36 +1,58 @@
 # RunAsTrustedInstaller
+
 A Windows command-line utility to run programs with TrustedInstaller privileges.
 
 ## Description
-On Windows, TrustedInstaller privileges sometimes can be helpful to modify/delete criticial system files/folders that are protected by the OS.  
-Likewise, there might be a need to deal with certain Registry keys that are protected with an ACL which restricts access to the TrustedInstaller account.  
+
+On Windows, TrustedInstaller privileges can sometimes be helpful for modifying or deleting criticial system files and folders that are protected by the OS.  
+Likewise, there may be a need to deal with certain registry keys that are protected by an ACL that restricts access to the TrustedInstaller account.  
 The utility was developed as a standalone executable and does not require any installation.
 
+Starting with Release 0.2, a Shell Extension Handler can optionally be installed, which provides an additional **"Run as TrustedInstaller"** context menu entry for `.exe` files in Windows Explorer. Note that both `RunAsTIShellExtension.dll` and `RunAsTI.exe` need to reside in the same directory.
+
 ## Getting Started
 
 ### Compilation
+
+```text
+MSBuild RunAsTI.sln
 ```
-cmake .
-cmake --build .
-```
-Alternatively, you can simply open `CMakeLists.txt` in Visual Studio and compile from there.
+
+Alternatively, you can simply open the `RunAsTI.sln` Solution File in Visual Studio and compile from there.
 
 ### Usage Examples
 
 Delete a file that cannot be deleted the regular way:
-```
+
+```text
 RunAsTI.exe cmd.exe /c del C:\Windows\system32\foobar.dat
 ```
 
-Open the Registry Editor to view/modify/delete Registry keys/values that are not accessible in normal operation mode:
-```
+Open the Registry Editor to view/modify/delete registry keys/values which are not accessible in normal operation mode:
+
+```text
 RunAsTI.exe C:\Windows\regedit.exe
 ```
 
+Install Shell Extension Handler:
+
+```text
+RunAsTI.exe /install
+```
+
+Uninstall Shell Extension Handler:
+
+```text
+RunAsTI.exe /uninstall
+```
+
 ## Version History
 
+* 0.2
+  * Added Shell Extension Handler support
 * 0.1
-    * Initial Release
+  * Initial Release
 
 ## License
-This project is licensed under the MIT License.
+
+This project is licensed under the MIT License.

CMakePresets.json

@@ -1,4 +1,5 @@
 #include <iostream>
+#include <Shlwapi.h>
 
 #include "Utils.h"
 
@@ -12,7 +13,13 @@ int main()
 
 	if (lpArgs != NULL)
 	{
-		if (nArgs > 1)
+		if (nArgs == 2 && !_wcsicmp(lpArgs[1], L"/install")) {
+			ShellExecute(NULL, L"open", L"regsvr32.exe", L"/i RunAsTIShellExtension.dll", NULL, SW_SHOWNORMAL);
+		}
+		else if (nArgs == 2 && !_wcsicmp(lpArgs[1], L"/uninstall")) {
+			ShellExecute(NULL, L"open", L"regsvr32.exe", L"/u RunAsTIShellExtension.dll", NULL, SW_SHOWNORMAL);
+		}
+		else if (nArgs > 1)
 		{
 			std::wstring cmdApp;
 			std::wstring cmdArgs;
@@ -25,10 +32,12 @@ int main()
 				lpCommandLine++;
 			}
 
-			if(nArgs > 2)
+			if (nArgs > 2) {
 				std::wcout << "Executing '" << cmdApp.c_str() << "' with args '" << cmdArgs.c_str() << "'..." << std::endl;
-			else
+			}
+			else {
 				std::wcout << "Executing '" << cmdApp.c_str() << "'..." << std::endl;
+			}
 
 			if (ExecuteCommand(cmdApp, cmdArgs))
 			{
@@ -40,7 +49,11 @@ int main()
 			}
 		}
 		else {
-			std::wcout << "Usage: " << *lpArgs << " <cmdline>" << std::endl;
+			std::wstring exeName = *lpArgs;
+			PathStripPath(&exeName[0]);
+			std::wcout << "Usage: " << exeName.c_str() << " <cmdline>    Executes <cmdline> with TrustedInstaller privileges." << std::endl;
+			std::wcout << "       " << exeName.c_str() << " /install     Installs Shell Extension Handler." << std::endl;
+			std::wcout << "       " << exeName.c_str() << " /uninstall   Uninstalls Shell Extension Handler." << std::endl;
 		}
 		LocalFree(lpArgs);
 	}

LICENSE

@@ -53,8 +53,8 @@ END
 //
 
 VS_VERSION_INFO VERSIONINFO
- FILEVERSION 0,1,0,0
- PRODUCTVERSION 0,1,0,0
+ FILEVERSION 0,2,0,0
+ PRODUCTVERSION 0,2,0,0
  FILEFLAGSMASK 0x3fL
 #ifdef _DEBUG
  FILEFLAGS 0x1L
@@ -71,12 +71,12 @@ BEGIN
         BEGIN
             VALUE "CompanyName", "mbcdev"
             VALUE "FileDescription", "RunAsTrustedInstaller"
-            VALUE "FileVersion", "0.1.0.0"
+            VALUE "FileVersion", "0.2.0.0"
             VALUE "InternalName", "RunAsTI.exe"
-            VALUE "LegalCopyright", "Copyright (c) 2023 mbcdev"
+            VALUE "LegalCopyright", "Copyright (c) 2023-2024 mbcdev"
             VALUE "OriginalFilename", "RunAsTI.exe"
             VALUE "ProductName", "RunAsTrustedInstaller"
-            VALUE "ProductVersion", "0.1.0.0"
+            VALUE "ProductVersion", "0.2.0.0"
         END
     END
     BLOCK "VarFileInfo"

README.md

@@ -0,0 +1,34 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.12.35506.116 d17.12
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "RunAsTI", "RunAsTI.vcxproj", "{A39C5F40-DD2B-3A32-B8B5-5FD7CA1DF167}"
+	ProjectSection(ProjectDependencies) = postProject
+		{4B847C33-2D23-410A-8A48-FBE9F0EEA96E} = {4B847C33-2D23-410A-8A48-FBE9F0EEA96E}
+	EndProjectSection
+EndProject
+Project("{8BC9CEB8-8B4A-11D0-8D11-00A0C91BC942}") = "RunAsTIShellExtension", "ShellExtension\RunAsTIShellExtension.vcxproj", "{4B847C33-2D23-410A-8A48-FBE9F0EEA96E}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|x64 = Debug|x64
+		Release|x64 = Release|x64
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{A39C5F40-DD2B-3A32-B8B5-5FD7CA1DF167}.Debug|x64.ActiveCfg = Debug|x64
+		{A39C5F40-DD2B-3A32-B8B5-5FD7CA1DF167}.Debug|x64.Build.0 = Debug|x64
+		{A39C5F40-DD2B-3A32-B8B5-5FD7CA1DF167}.Release|x64.ActiveCfg = Release|x64
+		{A39C5F40-DD2B-3A32-B8B5-5FD7CA1DF167}.Release|x64.Build.0 = Release|x64
+		{4B847C33-2D23-410A-8A48-FBE9F0EEA96E}.Debug|x64.ActiveCfg = Debug|x64
+		{4B847C33-2D23-410A-8A48-FBE9F0EEA96E}.Debug|x64.Build.0 = Debug|x64
+		{4B847C33-2D23-410A-8A48-FBE9F0EEA96E}.Release|x64.ActiveCfg = Release|x64
+		{4B847C33-2D23-410A-8A48-FBE9F0EEA96E}.Release|x64.Build.0 = Release|x64
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {4F263B2A-4489-35EE-915B-91872F54CF5C}
+	EndGlobalSection
+EndGlobal