Initialversion

2026-08-09 13:27:53 +02:00
commit eec4f52b5a
25 changed files with 2123 additions and 0 deletions
@@ -0,0 +1,117 @@
+# Plandent MSTSC Script Hook
+
+Kleines Windows-Projekt, das beim erfolgreichen Aufbau einer klassischen RDP-Verbindung mit `mstsc.exe` lokal ein konfiguriertes Script startet.
+
+## Komponenten
+
+- **PlandentMstscScriptHook.dll** – native x64 DVC-Plugin-DLL für den Remote Desktop Connection Client.
+- **PlandentMstscScriptHook.exe** – WinForms-Konfigurator/Installer. Die Release-EXE enthält die DLL als Resource und extrahiert sie bei der Installation.
+
+## Verhalten
+
+Die DLL implementiert `IWTSPlugin` und exportiert `VirtualChannelGetInstance`.
+
+- `Initialize()` – Plugin wird von MSTSC initialisiert.
+- `Connected()` – liest die Konfiguration und startet das lokale Script.
+- `Disconnected()` – beendet das von dieser Plugin-Instanz gestartete Script, wenn `StopOnDisconnect=1` gesetzt ist.
+- `Terminated()` – bereinigt Prozesshandles; bei `StopOnDisconnect=0` läuft das Script weiter.
+
+Der Plugin-Callback wartet **nicht** auf das Script. Es wird nur mit `CreateProcessW` gestartet und der Callback kehrt direkt zurück.
+
+## Registry
+
+MSTSC-Registrierung pro Benutzer:
+
+```text
+HKCU\Software\Microsoft\Terminal Server Client\Default\AddIns\PlandentMstscScriptHook
+    Name = C:\Users\<Benutzer>\AppData\Local\Plandent\MstscScriptHook\PlandentMstscScriptHook.dll
+```
+
+Konfiguration:
+
+```text
+HKCU\Software\Plandent\MstscScriptHook
+    Enabled             REG_DWORD       1
+    ScriptPath          REG_EXPAND_SZ   C:\RemoteVDDS\RemoteVDDS_Receiver_TS.bat
+    Arguments           REG_SZ          MIN
+    WorkingDirectory    REG_EXPAND_SZ   C:\RemoteVDDS
+    StartOnConnect      REG_DWORD       1
+    StopOnDisconnect    REG_DWORD       0
+    Hidden              REG_DWORD       1
+    PreventDuplicates   REG_DWORD       1
+    EnableLogging       REG_DWORD       1
+```
+
+## Unterstützte Starttypen
+
+- `.bat` / `.cmd` → `cmd.exe /D /S /C ...`
+- `.ps1` → Windows PowerShell mit `-NoProfile -NonInteractive -ExecutionPolicy Bypass -File ...`
+- `.exe` → direkter Start
+
+Bei `Hidden=1` wird `CREATE_NO_WINDOW` verwendet und `SW_HIDE` gesetzt.
+
+## Mehrfachstartschutz
+
+Bei `PreventDuplicates=1` wird aus dem expandierten Scriptpfad ein Named Mutex erzeugt. Das Mutex-Handle wird gezielt an den gestarteten Prozess vererbt. Damit bleibt der Schutz bestehen, solange der Receiver läuft – auch wenn die ursprüngliche `mstsc.exe`-Instanz bereits beendet wurde.
+
+Der Schutz ist bewusst `Local\\...`, also auf die lokale Windows-Sitzung begrenzt.
+
+## Logging
+
+Bei aktiviertem Logging:
+
+```text
+%LOCALAPPDATA%\Plandent\MstscScriptHook\plugin.log
+```
+
+Die GUI enthält einen Button **Log öffnen**.
+
+## Voraussetzungen zum Bauen
+
+- Windows 10/11 x64
+- Visual Studio 2022 oder Visual Studio Build Tools 2022
+- Workload **Desktopentwicklung mit C++**
+- Windows 10/11 SDK
+- .NET 8 SDK
+
+## Release bauen
+
+PowerShell im Projektverzeichnis:
+
+```powershell
+.\build-release.ps1 -Clean
+```
+
+Ergebnis:
+
+```text
+dist\PlandentMstscScriptHook.exe
+```
+
+Die veröffentlichte EXE ist x64, self-contained und enthält die native Plugin-DLL als Resource.
+
+## Installation
+
+1. `PlandentMstscScriptHook.exe` starten.
+2. Script über `...` auswählen.
+3. Für `RemoteVDDS_Receiver_TS.bat` als Argument `MIN` setzen.
+4. Optional Arbeitsverzeichnis auswählen; standardmäßig sollte es dem Scriptverzeichnis entsprechen.
+5. **Script testen** und anschließend **Test beenden**.
+6. **Plugin installieren** anklicken.
+7. Alle bereits laufenden `mstsc.exe`-Instanzen schließen.
+8. MSTSC neu starten und eine RDP-Verbindung herstellen.
+
+Die Installation erfolgt nur unter `HKCU` und `%LOCALAPPDATA%`; dafür sind normalerweise keine Administratorrechte nötig.
+
+## Deinstallation
+
+**Plugin entfernen** löscht den MSTSC-Registryeintrag und die installierte DLL. Ist die DLL noch in einer laufenden `mstsc.exe` geladen, wird zumindest die Registrierung entfernt; nach dem Schließen aller MSTSC-Instanzen kann die DLL erneut über den Button entfernt werden.
+
+Die Script-Konfiguration unter `HKCU\Software\Plandent\MstscScriptHook` bleibt absichtlich erhalten.
+
+## Wichtige Grenzen
+
+- Das Plugin ist für den klassischen Microsoft RDC-Pluginmechanismus ausgelegt. Andere RDP-Clients müssen diesen Mechanismus ebenfalls unterstützen, sonst wird die DLL nicht geladen.
+- `StopOnDisconnect` beendet nur den vom Plugin selbst gestarteten Root-Prozess. Beim RemoteVDDS-BAT ist das der dauerhaft laufende `cmd.exe`-Receiver.
+- Das Script läuft mit den Rechten des lokalen Benutzers, der `mstsc.exe` gestartet hat.
+- AppLocker/WDAC oder andere Application-Control-Richtlinien können das Laden einer nicht signierten DLL bzw. das Starten des Scripts blockieren.