# 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.