chore: initial commit (extracted from Launchers monorepo)

Plugin: nsShellExecAsUser v1.0.0 Architectures: x86-ansi, x86-unicode, amd64-unicode License: zlib
2026-04-29 14:04:59 +02:00
commit c98a0d37d9
30 changed files with 3109 additions and 0 deletions
@@ -0,0 +1,100 @@
+# nsShellExecAsUser NSIS Plugin
+
+**Versione personale modificata**
+
+---
+
+## Descrizione Originale
+
+**ShellExecAsUser plug-in**
+
+Execute the specified program using ShellExecute.
+Useful when the installer process is running with elevated privileges (UAC) but you want to launch an application as the standard logged-in user (e.g., launching the application after installation).
+
+## Features
+
+- Launches applications as the current desktop user
+- Bypasses UAC elevation if the installer is running as Administrator
+- Supports standard ShellExecute verbs (open, runas, print, etc.)
+- Supports window show modes (SW_SHOWNORMAL, SW_HIDE, etc.)
+- Win95/98/ME/NT/2000/XP/Vista/7/8/10/11 support
+- NSIS UNICODE support
+
+## Usage
+
+```nsis
+ShellExecAsUser::ShellExecAsUser "action" "command" "parameters" "show_mode"
+```
+
+**Parameters:**
+
+1. `action` - The verb to use (e.g., "open", "runas", "print"). Can be empty `""` for default action.
+2. `command` - Path to the executable or file to open.
+3. `parameters` - Command line arguments.
+4. `show_mode` - Window display mode.
+
+**Supported Show Modes:**
+
+- `SW_SHOWDEFAULT`
+- `SW_SHOWNORMAL` (default)
+- `SW_SHOWMAXIMIZED`
+- `SW_SHOWMINIMIZED`
+- `SW_HIDE`
+
+**Working Directory:**
+
+The plugin uses the current NSIS output directory (`$OUTDIR`) as the working directory for the launched process.
+
+## Example
+
+```nsis
+Section "Launch Application"
+    SetOutPath "$INSTDIR"
+    ShellExecAsUser::ShellExecAsUser "open" "$INSTDIR\MyApp.exe" "" "SW_SHOWNORMAL"
+SectionEnd
+```
+
+To launch a URL in the default browser as the user:
+```nsis
+ShellExecAsUser::ShellExecAsUser "open" "https://example.com" "" "SW_SHOWNORMAL"
+```
+
+## Include file
+
+There is no wrapper macros file for this plugin. Call the plugin directly as shown in the usage section.
+
+---
+
+## ⚠️ Differenze nella versione personale
+
+### Architetture supportate
+
+Il progetto supporta le configurazioni già presenti nell'originale:
+- **amd64-unicode** (x64)
+- **x86-ansi**
+- **x86-unicode**
+
+### Progetto Visual Studio
+
+Il progetto è stato aggiornato e riorganizzato:
+- `Contrib/ShellExecAsUser/ShellExecAsUser.sln` - Solution VS2022
+- `Contrib/ShellExecAsUser/ShellExecAsUser.vcxproj` - Progetto VS2022 aggiornato
+
+### File aggiunti
+
+- `build_plugin.py` - Script Python per compilare il plugin per tutte le architetture supportate.
+- `nsis/` - Header NSIS inclusi per facilitare la compilazione.
+
+### Modifiche al Codice
+
+- **Rimozione Warning Deprecazione**: Sostituita la chiamata deprecata `GetVersionEx` in `VistaTools.cxx` con la moderna API `VerifyVersionInfo` per evitare warning C4996 durante la compilazione con i toolset moderni.
+- **Aggiornamento Build**: Configurazione aggiornata per utilizzare il toolset **v143** (Visual Studio 2022).
+
+### Compilazione
+
+```cmd
+cd nsShellExecAsUser
+python build_plugin.py
+```
+
+I DLL vengono copiati in `plugins/{platform}/ShellExecAsUser.dll`.