356 lines
15 KiB
Markdown
356 lines
15 KiB
Markdown
# RDP Wrapper Library by Stas'M
|
|
|
|
The goal of this project is to enable Remote Desktop Host support and concurrent RDP sessions on reduced functionality systems for home usage.
|
|
|
|
RDP Wrapper works as a layer between Service Control Manager and Terminal Services, so the original termsrv.dll file remains untouched. Also this method is very strong against Windows Update.
|
|
|
|
[pVistaST]: http://stascorp.com/images/rdpwrap/pVistaST.jpg
|
|
[pVistaHB]: http://stascorp.com/images/rdpwrap/pVistaHB.jpg
|
|
[pWin7ST]: http://stascorp.com/images/rdpwrap/pWin7ST.jpg
|
|
[pWin7HB]: http://stascorp.com/images/rdpwrap/pWin7HB.jpg
|
|
[pWin8DP]: http://stascorp.com/images/rdpwrap/pWin8DP.jpg
|
|
[pWin8CP]: http://stascorp.com/images/rdpwrap/pWin8CP.jpg
|
|
[pWin8RP]: http://stascorp.com/images/rdpwrap/pWin8RP.jpg
|
|
[pWin8]: http://stascorp.com/images/rdpwrap/pWin8.jpg
|
|
[pWin81P]: http://stascorp.com/images/rdpwrap/pWin81P.jpg
|
|
[pWin81]: http://stascorp.com/images/rdpwrap/pWin81.jpg
|
|
[pWin10TP]: http://stascorp.com/images/rdpwrap/pWin10TP.jpg
|
|
[pWin10PTP]: http://stascorp.com/images/rdpwrap/pWin10PTP.jpg
|
|
[pWin10]: http://stascorp.com/images/rdpwrap/pWin10.jpg
|
|
|
|
[fVistaST]: http://stascorp.com/images/rdpwrap/VistaST.png
|
|
[fVistaHB]: http://stascorp.com/images/rdpwrap/VistaHB.png
|
|
[fWin7ST]: http://stascorp.com/images/rdpwrap/Win7ST.png
|
|
[fWin7HB]: http://stascorp.com/images/rdpwrap/Win7HB.png
|
|
[fWin8DP]: http://stascorp.com/images/rdpwrap/Win8DP.png
|
|
[fWin8CP]: http://stascorp.com/images/rdpwrap/Win8CP.png
|
|
[fWin8RP]: http://stascorp.com/images/rdpwrap/Win8RP.png
|
|
[fWin8]: http://stascorp.com/images/rdpwrap/Win8.png
|
|
[fWin81P]: http://stascorp.com/images/rdpwrap/Win81P.png
|
|
[fWin81]: http://stascorp.com/images/rdpwrap/Win81.png
|
|
[fWin10TP]: http://stascorp.com/images/rdpwrap/Win10TP.png
|
|
[fWin10PTP]: http://stascorp.com/images/rdpwrap/Win10PTP.png
|
|
[fWin10]: http://stascorp.com/images/rdpwrap/Win10.png
|
|
|
|
| NT Version | Screenshots |
|
|
| ------------- | ----------- |
|
|
| Windows Vista | [![Windows Vista Starter][pVistaST]][fVistaST] [![Windows Vista Home Basic][pVistaHB]][fVistaHB] |
|
|
| Windows 7 | [![Windows 7 Starter][pWin7ST]][fWin7ST] [![Windows 7 Home Basic][pWin7HB]][fWin7HB] |
|
|
| Windows 8 | [![Windows 8 Developer Preview][pWin8DP]][fWin8DP] [![Windows 8 Consumer Preview][pWin8CP]][fWin8CP] [![Windows 8 Release Preview][pWin8RP]][fWin8RP] [![Windows 8][pWin8]][fWin8] |
|
|
| Windows 8.1 | [![Windows 8.1 Preview][pWin81P]][fWin81P] [![Windows 8.1][pWin81]][fWin81] |
|
|
| Windows 10 | [![Windows 10 Technical Preview][pWin10TP]][fWin10TP] [![Windows 10 Pro Technical Preview][pWin10PTP]][fWin10PTP] [![Windows 10][pWin10]][fWin10] |
|
|
---
|
|
[WinPPE]: http://forums.mydigitallife.info/threads/39411-Windows-Product-Policy-Editor
|
|
|
|
This solution was inspired by [Windows Product Policy Editor][WinPPE], big thanks to **kost** :)
|
|
|
|
— binarymaster
|
|
|
|
### Attention:
|
|
It's recommended to have original termsrv.dll file with the RDP Wrapper installation. If you have modified it before with other patchers, it may become unstable and crash in any moment.
|
|
|
|
### Information:
|
|
- Source code is available, so you can build it on your own
|
|
- RDP Wrapper does not patch termsrv.dll, it loads termsrv with different parameters
|
|
- RDPWInst and RDPChecker can be redistributed without development folder and batch files
|
|
- RDPWInst can be used for unattended installation / deployment
|
|
- Windows 2000, XP and Server 2003 will not be supported
|
|
|
|
### Porting to other platforms:
|
|
- **ARM** for Windows RT (see links below)
|
|
- **IA-64** for Itanium-based Windows Server? *Well, I have no idea* :)
|
|
|
|
### Building the binaries:
|
|
- **x86 Delphi version** can be built with *Embarcadero RAD Studio 2010*
|
|
- **x86/x64 C++ version** can be built with *Microsoft Visual Studio 2013*
|
|
|
|
[andrewblock]: http://andrewblock.net/2013/07/19/enable-remote-desktop-on-windows-8-core/
|
|
[mydigitallife]: http://forums.mydigitallife.info/threads/55935-RDP-Wrapper-Library-(works-with-Windows-8-1-Basic)
|
|
[xda-dev]: http://forum.xda-developers.com/showthread.php?t=2093525&page=3
|
|
[yt-updating]: http://www.youtube.com/watch?v=W9BpbEt1yJw
|
|
[yt-offsets]: http://www.youtube.com/watch?v=FiD86tmRBtk
|
|
|
|
### Links:
|
|
- Official GitHub repository:
|
|
<br>https://github.com/stascorp/rdpwrap/
|
|
- Active discussion in the comments here:
|
|
<br>[Enable remote desktop on Windows 8 core / basic - Andrew Block .net][andrewblock]
|
|
- MDL Projects and Applications thread here:
|
|
<br>[RDP Wrapper Library (works with Windows 8.1 Basic)][mydigitallife]
|
|
- Some ideas about porting to ARM for Windows RT (post #23):
|
|
<br>[\[Q\] Mod Windows RT to enable Remote Desktop][xda-dev]
|
|
- Adding «Remote Desktop Users» group:
|
|
<br>http://superuser.com/questions/680572/
|
|
|
|
#### Tutorial videos:
|
|
- [~~Updating RDP Wrapper INI file manually~~][yt-updating] (now use installer to update INI file)
|
|
- [How to find offsets for new termsrv.dll versions][yt-offsets]
|
|
|
|
### Files in release package:
|
|
|
|
| File name | Description |
|
|
| --------- | ----------- |
|
|
| `RDPWInst.exe` | RDP Wrapper Library installer/uninstaller |
|
|
| `RDPCheck.exe` | Local RDP Checker (you can check the RDP is working) |
|
|
| `RDPConf.exe` | RDP Wrapper Configuration |
|
|
| `install.bat` | Quick install batch file |
|
|
| `uninstall.bat` | Quick uninstall batch file |
|
|
| `update.bat` | Quick update batch file |
|
|
|
|
### Frequently Asked Questions
|
|
|
|
> Where can I download the installer or binaries?
|
|
|
|
In the [GitHub Releases](https://github.com/stascorp/rdpwrap/releases) section.
|
|
|
|
> Is it legal to use this application?
|
|
|
|
There is no definitive answer, see [this discussion](https://github.com/stascorp/rdpwrap/issues/26).
|
|
|
|
> The installer tries to access the Internet, is it normal behaviour?
|
|
|
|
Yes, it works in online mode by default. You may disable it by removing `-o` flag in the `install.bat` file.
|
|
|
|
> What is online install mode?
|
|
|
|
Online install mode introduced in version 1.6.1. When you installing RDP Wrapper first time using this mode, it will download [latest INI file](https://github.com/stascorp/rdpwrap/blob/master/res/rdpwrap.ini) from GitHub. See [this discussion](https://github.com/stascorp/rdpwrap/issues/132).
|
|
|
|
> What is INI file and why we need it?
|
|
|
|
INI file was introduced in version 1.5. It stores system configuration for RDP Wrapper — general wrapping settings, binary patch codes, and per build specific data. When new `termsrv.dll` build comes out, developer adds support for it by updating INI file in repository.
|
|
|
|
> Config Tool reports version 1.5, but I installed higher version. What's the matter?
|
|
|
|
Beginning with version 1.5 the `rdpwrap.dll` is not updated anymore, since all settings are stored in INI file. Deal with it.
|
|
|
|
> Config Tool shows `[not supported]` and RDP doesn't work. What can I do?
|
|
|
|
Make sure you're connected to the Internet and run `update.bat`.
|
|
|
|
> Update doesn't help, it still shows `[not supported]`.
|
|
|
|
Visit [issues](https://github.com/stascorp/rdpwrap/issues) section, and check whether your `termsrv.dll` build is listed here. If you can't find such issue, create a new — specify your build version for adding to support.
|
|
|
|
> Why `RDPCheck` doesn't allow to change resolution and other settings?
|
|
|
|
`RDPCheck` is a very simple application and only for testing purposes. You need to use Microsoft Remote Desktop Client (`mstsc.exe`) if you want to customize the settings. You can use `127.0.0.1` or `127.0.0.2` address for loopback connection.
|
|
|
|
---
|
|
|
|
### Change log:
|
|
|
|
#### 2016.08.01
|
|
- Version 1.6.1
|
|
- Include updated INI file for latest Windows builds
|
|
- Installer updated
|
|
- Added online install mode
|
|
- Added feature to keep settings on uninstall
|
|
- RDP Config updated
|
|
- Fixed update firewall rule on RDP port change
|
|
- Added feature to hide users on logon
|
|
|
|
#### 2015.08.12
|
|
- Version 1.6
|
|
- Added support for Windows 10
|
|
- INI file has smaller size now - all comments are moved to KB file
|
|
- Installer updated
|
|
- Added workaround for 1056 error (although it isn't an error)
|
|
- Added update support to installer
|
|
- Newest RDPClip versions are included with installer
|
|
- RDP Checker updated
|
|
- Changed connect IP to 127.0.0.2
|
|
- Updated some text messages
|
|
- RDP Config updated
|
|
- Added all possible shadowing modes
|
|
- Also it will write settings to the group policy
|
|
|
|
#### 2014.12.11
|
|
- Version 1.5
|
|
- Added INI config support
|
|
- Configuration is stored in INI file now
|
|
- We can extend version support without building new binaries
|
|
- Added support for Windows 8.1 with KB3000850
|
|
- Added support for Windows 10 Technical Preview Update 2
|
|
- Installer updated
|
|
- RDP Config updated
|
|
- Diagnostics feature added to RDP Config
|
|
|
|
#### 2014.11.14
|
|
- Version 1.4
|
|
- Added support for Windows 10 Technical Preview Update 1
|
|
- Added support for Windows Vista SP2 with KB3003743
|
|
- Added support for Windows 7 SP1 with KB3003743
|
|
- Added new RDP Configuration Program
|
|
|
|
#### 2014.10.21
|
|
- Installer updated
|
|
- Added feature to install RDP Wrapper to System32 directory
|
|
- Fixed issue in the installer - NLA setting now remains unchanged
|
|
- Local RDP Checker updated
|
|
- SecurityLayer and UserAuthentification values changed on check start
|
|
- RDP Checker restores values on exit
|
|
|
|
#### 2014.10.20
|
|
- Version 1.3
|
|
- Added support for Windows 10 Technical Preview
|
|
- Added support for Windows 7 with KB2984972
|
|
- Added support for Windows 8 with KB2973501
|
|
- Added extended support for Windows Vista (SP0, SP1 and SP2)
|
|
- Added extended support for Windows 7 (SP0 and SP1)
|
|
- Some improvements in the source code
|
|
- Installer updated to v2.2
|
|
- Fixed installation bug in Vista x64 (wrong expand path)
|
|
- Local RDP Checker updated
|
|
- Added description to error 0x708
|
|
|
|
#### 2014.07.26
|
|
- Version 1.2
|
|
- Added support for Windows 8 Developer Preview
|
|
- Added support for Windows 8 Consumer Preview
|
|
- Added support for Windows 8 Release Preview
|
|
- Added support for Windows 8.1 Preview
|
|
- Added support for Windows 8.1
|
|
- More details you will see in the source code
|
|
- Installer updated to v2.1
|
|
|
|
#### 2013.12.09
|
|
- C++ port of RDP Wrapper was made by Fusix
|
|
- x64 architecture is supported now
|
|
- Added new command line installer v2.0
|
|
- Added local RDP checker
|
|
- Source code (C++ port, installer 2.0, local RDP checker) is also included
|
|
|
|
#### 2013.10.25
|
|
- Version 1.1 source code is available
|
|
|
|
#### 2013.10.22
|
|
- Version 1.1
|
|
- Stable release
|
|
- Improved wrapper (now it can wrap internal unexported termsrv.dll SL Policy function)
|
|
- Added support for Windows 8 Single Language (tested on Acer Tablet PC with Intel Atom Z2760)
|
|
|
|
#### 2013.10.19
|
|
- Version 1.0
|
|
- First [beta] version
|
|
- Basic SL Policy wrapper
|
|
|
|
---
|
|
|
|
#### Supported Terminal Services versions:
|
|
- 6.0.X.X (Windows Vista / Server 2008)
|
|
- 6.0.6000.16386 (Windows Vista)
|
|
- 6.0.6001.18000 (Windows Vista SP1)
|
|
- 6.0.6002.18005 (Windows Vista SP2)
|
|
- 6.0.6002.19214 (Windows Vista SP2 with KB3003743 GDR)
|
|
- 6.0.6002.23521 (Windows Vista SP2 with KB3003743 LDR)
|
|
- 6.1.X.X (Windows 7 / Server 2008 R2)
|
|
- 6.1.7600.16385 (Windows 7)
|
|
- 6.1.7601.17514 (Windows 7 SP1)
|
|
- 6.1.7601.18540 (Windows 7 SP1 with KB2984972 GDR)
|
|
- 6.1.7601.22750 (Windows 7 SP1 with KB2984972 LDR)
|
|
- 6.1.7601.18637 (Windows 7 SP1 with KB3003743 GDR)
|
|
- 6.1.7601.22843 (Windows 7 SP1 with KB3003743 LDR)
|
|
- 6.1.7601.23403 (Windows 7 SP1 with KB3125574)
|
|
- 6.2.8102.0 (Windows 8 Developer Preview)
|
|
- 6.2.8250.0 (Windows 8 Consumer Preview)
|
|
- 6.2.8400.0 (Windows 8 Release Preview)
|
|
- 6.2.9200.16384 (Windows 8 / Server 2012)
|
|
- 6.2.9200.17048 (Windows 8 with KB2973501 GDR)
|
|
- 6.2.9200.21166 (Windows 8 with KB2973501 LDR)
|
|
- 6.3.9431.0 (Windows 8.1 Preview)
|
|
- 6.3.9600.16384 (Windows 8.1 / Server 2012 R2)
|
|
- 6.3.9600.17095 (Windows 8.1 with KB2959626)
|
|
- 6.3.9600.17415 (Windows 8.1 with KB3000850)
|
|
- 6.4.9841.0 (Windows 10 Technical Preview)
|
|
- 6.4.9860.0 (Windows 10 Technical Preview Update 1)
|
|
- 6.4.9879.0 (Windows 10 Technical Preview Update 2)
|
|
- 10.0.9926.0 (Windows 10 Pro Technical Preview)
|
|
- 10.0.10041.0 (Windows 10 Pro Technical Preview Update 1)
|
|
- 10.0.10240.16384 (Windows 10 RTM)
|
|
- 10.0.10586.0 (Windows 10 TH2 Release 151029-1700)
|
|
- 10.0.10586.589 (Windows 10 TH2 Release 160906-1759 with KB3185614)
|
|
- 10.0.11082.1000 (Windows 10 RS1 Release 151210-2021)
|
|
- 10.0.11102.1000 (Windows 10 RS1 Release 160113-1800)
|
|
- 10.0.14251.1000 (Windows 10 RS1 Release 160124-1059)
|
|
- 10.0.14271.1000 (Windows 10 RS1 Release 160218-2310)
|
|
- 10.0.14279.1000 (Windows 10 RS1 Release 160229-1700)
|
|
- 10.0.14295.1000 (Windows 10 RS1 Release 160318-1628)
|
|
- 10.0.14300.1000 (Windows Server 2016 Technical Preview 5)
|
|
- 10.0.14316.1000 (Windows 10 RS1 Release 160402-2227)
|
|
- 10.0.14328.1000 (Windows 10 RS1 Release 160418-1609)
|
|
- 10.0.14332.1001 (Windows 10 RS1 Release 160422-1940)
|
|
- 10.0.14342.1000 (Windows 10 RS1 Release 160506-1708)
|
|
- 10.0.14352.1002 (Windows 10 RS1 Release 160522-1930)
|
|
- 10.0.14366.0 (Windows 10 RS1 Release 160610-1700)
|
|
- 10.0.14367.0 (Windows 10 RS1 Release 160613-1700)
|
|
- 10.0.14372.0 (Windows 10 RS1 Release 160620-2342)
|
|
- 10.0.14379.0 (Windows 10 RS1 Release 160627-1607)
|
|
- 10.0.14383.0 (Windows 10 RS1 Release 160701-1839)
|
|
- 10.0.14385.0 (Windows 10 RS1 Release 160706-1700)
|
|
- 10.0.14388.0 (Windows 10 RS1 Release 160709-1635)
|
|
- 10.0.14393.0 (Windows 10 RS1 Release 160715-1616)
|
|
- 10.0.14901.1000 (Windows 10 RS Pre-Release 160805-1700)
|
|
- 10.0.14905.1000 (Windows 10 RS Pre-Release 160811-1739)
|
|
- 10.0.14915.1000 (Windows 10 RS Pre-Release 160826-1902)
|
|
|
|
#### Confirmed working on:
|
|
- Windows Vista Starter (x86 - Service Pack 1 and higher)
|
|
- Windows Vista Home Basic
|
|
- Windows Vista Home Premium
|
|
- Windows Vista Business
|
|
- Windows Vista Enterprise
|
|
- Windows Vista Ultimate
|
|
- Windows Server 2008
|
|
- Windows 7 Starter
|
|
- Windows 7 Home Basic
|
|
- Windows 7 Home Premium
|
|
- Windows 7 Professional
|
|
- Windows 7 Enterprise
|
|
- Windows 7 Ultimate
|
|
- Windows Server 2008 R2
|
|
- Windows 8 Developer Preview
|
|
- Windows 8 Consumer Preview
|
|
- Windows 8 Release Preview
|
|
- Windows 8
|
|
- Windows 8 Single Language
|
|
- Windows 8 Pro
|
|
- Windows 8 Enterprise
|
|
- Windows Server 2012
|
|
- Windows 8.1 Preview
|
|
- Windows 8.1
|
|
- Windows 8.1 Connected (with Bing)
|
|
- Windows 8.1 Single Language
|
|
- Windows 8.1 Connected Single Language (with Bing)
|
|
- Windows 8.1 Pro
|
|
- Windows 8.1 Enterprise
|
|
- Windows Server 2012 R2
|
|
- Windows 10 Technical Preview
|
|
- Windows 10 Pro Technical Preview
|
|
- Windows 10 Home
|
|
- Windows 10 Home Single Language
|
|
- Windows 10 Pro
|
|
- Windows 10 Enterprise
|
|
- Windows Server 2016 Technical Preview
|
|
|
|
#### Known issues:
|
|
- Beginning with Windows 8 **on tablet PCs** inactive sessions will be logged out by system - [more info](https://github.com/stascorp/rdpwrap/issues/37)
|
|
- Beginning with Windows 10 you can accidentally lock yourself from PC - [more info](https://github.com/stascorp/rdpwrap/issues/50)
|
|
- RDP works, but termsrv.dll crashes on logon attempt - Windows Vista Starter RTM x86 (termsrv.dll `6.0.6000.16386`)
|
|
- If Terminal Services hangs at startup, try to add **`rdpwrap.dll`** to antivirus exclusions. Also try to isolate RDP Wrapper from other shared services by the command:
|
|
<br>`sc config TermService type= own`
|
|
- RDP Wrapper Installer can be removed by AVG Free Antivirus after reboot - add it to exclusions.
|
|
|
|
Installation instructions:
|
|
- Download latest release binaries and unpack files
|
|
- Right-click on **`install.bat`** and select Run as Administrator
|
|
- See command output for details
|
|
|
|
To update INI file:
|
|
- Right-click on **`update.bat`** and select Run as Administrator
|
|
- See command output for details
|
|
|
|
To uninstall:
|
|
- Go to the directory where you extracted the files
|
|
- Right-click on **`uninstall.bat`** and select Run as Administrator
|
|
- See command output for details
|