Plandent/Mstsc-Script-Hook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

1 Release 1 Tag

RSS Feed
  • 0.1.0 4c51989600
    Compare

    MSTSC Script Hook v0.1.0 Stable

    patrick released this 2026-08-11 14:34:52 +00:00 | 0 commits to main since this release

    Erste veröffentlichte Version des MSTSC Script Hook.

    Die Anwendung ermöglicht die kontrollierte Zusammenarbeit zwischen Programmen
    innerhalb einer RDP-/Terminalserver-Sitzung und lokal auf dem RDP-Client
    installierten Anwendungen.

    Highlights

    Automatischer Programmstart bei RDP-Verbindung

    Lokale Programme und Scripte können automatisch gestartet werden, sobald eine
    RDP-Verbindung über den klassischen Microsoft Remote Desktop Client
    mstsc.exe erfolgreich aufgebaut wurde.

    Unterstützt werden:

    • EXE
    • BAT
    • CMD
    • PowerShell

    Zusätzlich stehen Optionen für unsichtbaren Start und Mehrfachstartschutz zur
    Verfügung.

    RemoteVDDS-Unterstützung

    Die Scriptstart-Funktion kann zusammen mit den RemoteVDDS-Scripten von
    Tobias Bauer     verwendet werden.

    Damit lässt sich beispielsweise der RemoteVDDS-Receiver automatisch und
    unsichtbar auf dem lokalen Arbeitsplatz starten, sobald die RDP-Verbindung
    aufgebaut wird.

    Programmstart durch Terminalserver-Trigger

    Mit PlandentRdpClientTrigger.exe kann innerhalb der aktuellen RDP-Sitzung ein
    auf dem Client vorkonfiguriertes Programm gestartet werden.

    Der Terminalserver überträgt dabei weder Programmpfad noch Argumente. Die
    Konfiguration bleibt vollständig auf dem lokalen Client.

    Die Kommunikation erfolgt über einen RDP Dynamic Virtual Channel und benötigt
    keine zusätzlichen Netzwerkports oder Firewallfreigaben.

    SIOMIN-/Sidexis-Bridge

    PlandentSiominClientTrigger.exe ermöglicht die Verbindung einer Anwendung
    innerhalb der Terminalserver-Sitzung mit einem lokal installierten Sidexis.

    Der Trigger:

    1. ermittelt den tatsächlichen Hostnamen des lokalen RDP-Clients,
    2. liest einen temporären SIOMIN-/SLIDA-Eintrag,
    3. ersetzt den darin enthaltenen Terminalservernamen durch den Clientnamen,
    4. korrigiert die interne SIOMIN-Datensatzlänge,
    5. hängt den Eintrag an die finale siomin.sdx an,
    6. leert nach erfolgreicher Übernahme die temporäre Datei,
    7. startet anschließend das auf dem Client konfigurierte Programm.

    Dadurch kann innerhalb einer Terminalanwendung als Sidexis-EXE der
    PlandentSiominClientTrigger.exe verwendet werden, während Sidexis selbst auf
    dem lokalen Arbeitsplatz ausgeführt wird.

    Typische Konfiguration:

    [SIOMIN]
SIOMIN_TEMP_PATH=C:\PDATA\temp_siomin.sdx
SIOMIN_PATH=\\SERVER\PDATA\siomin.sdx
DEBUG=0

    Zuverlässige Client-Erkennung

    Der Client-Hostname wird direkt über das MSTSC-Plugin vom lokalen Rechner
    ermittelt.

    Dadurch ist die Funktion unabhängig davon, ob der Terminalserver den
    Clientnamen über CLIENTNAME, COMPUTERNAME oder gar nicht in die Sitzung
    übernimmt.

    Native Windows-Implementierung

    Alle Komponenten sind als native x64-C++-Anwendungen umgesetzt.

    Es werden keine zusätzlichen .NET-, NuGet- oder WindowsDesktop-Runtimes
    benötigt.

    Die Release-Dateien bestehen aus:

    PlandentMstscScriptHook.exe
PlandentRdpClientTrigger.exe
PlandentSiominClientTrigger.exe

    Die benötigte MSTSC-Plugin-DLL ist direkt in
    PlandentMstscScriptHook.exe eingebettet und wird bei der Installation
    automatisch extrahiert und registriert.

    Logging und Diagnose

    Das Client-Plugin unterstützt optionales Logging nach:

    %LOCALAPPDATA%\Plandent\MstscScriptHook\plugin.log

    Der SIOMIN-Trigger kann über:

    DEBUG=1

    eine zusätzliche Logdatei neben der EXE erzeugen.

    Damit können unter anderem DVC-Verbindungen, Client-Hostname, SIOMIN-Verarbeitung,
    Programmstarts und Fehler nachvollzogen werden.

    Dokumentation

    Version 0.1.0 enthält:

    • überarbeitete Projekt-README
    • Techniker-Dokumentation für das Wiki
    • ausführliche Entwicklerdokumentation
    • proprietäre Lizenz

    Voraussetzungen

    • Windows x64
    • klassischer Microsoft Remote Desktop Client mstsc.exe
    • RDP-Verbindung zum Terminalserver

    Für den Build:

    • Visual Studio 2022 oder Build Tools
    • Desktopentwicklung mit C++
    • Windows 10/11 SDK

    Lizenz

    Copyright (c) 2026 Patrick Gniza.
    All rights reserved.

    Die Software ist proprietär. Siehe LICENSE.

    Hinweis zu Drittkomponenten

    Die RemoteVDDS-Scripte von Tobias Bauer sind nicht Bestandteil dieses Releases.

    Downloads