Microsoft KB Archive/186499

= Terminal Server registry settings for applications =

Article ID: 186499

Article Last Modified on 3/22/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)
 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows NT Server 4.0, Terminal Server Edition

-



This article was previously published under Q186499



IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry



SUMMARY
This article discusses the registry settings that can be used to modify application behavior on a Terminal Server computer.



Controlling Application Execution in Execute Mode
Several compatibility bits can be set for an application, registry path, or .ini file to change how a Terminal Server computer handles the merging of application initialization data when a session is in execute mode. These compatibility bits are set in the registry under the following subkey:

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Terminal Server\Compatibility

There are three separate keys for applications, .ini files, and registry entries under this registry path.

The default settings work for most applications, but they can be further tuned by using the following compatibility bits.

WARNING: These compatibility bits should only be changed if an application is not working properly.

The first set of compatibility bits indicates the version of the application that the settings are for. Not all combinations are useful (for example, an MS-DOS application does make registry calls). Because the path to the file is not specified and multiple applications may use the same file name (for example, Setup.exe and Install.exe are now regularly used for installation programs), specify the application type to help make sure that the compatibility settings do not affect other applications with the same file name.

To determine the String Value, add the values of the bits that you want to set. For example, to return the user name instead of the computer name for both 16-bit and 32-bit versions of Myapp.exe, create a subkey in the registry by performing the following steps.

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

 Start Registry Editor. Locate the following registry subkey:

HKEY_LOCAL_MACHINE \Software\Microsoft\Windows NT\CurrentVersion\Terminal Server\Compatibility\Applications\Myapp

 On the Edit menu, click Add Value, and type the following information:

Value Name: Flags

Type: REG_DWORD

 In the Data box, type the hex value of 11C (add 0x00000004 for 16-bit Windows applications, add 0x00000008 for 32-bit Windows applications, add 0x00000010 to return the user name instead of the computer name, and add 0x00000100 to disable registry mapping).

Applications
The following compatibility bits affect the application when it is running. They are located in the following registry subkey (where Appname is the name of the application's executable file):

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Terminal Server\Compatibility\Applications\Appname

Compatibility Bits

 * MS-DOS application: 0x00000001
 * OS/2 application: 0x00000002
 * Windows 16-bit application: 0x00000004
 * Windows 32-bit application: 0x00000008
 * Return user name instead of computer name: 0x00000010
 * Return Terminal Server build number: 0x00000020
 * Disable registry mapping for this application: 0x00000100
 * Do not substitute user Windows directory: 0x00000400
 * Limit the reported memory: 0x00000800

Use the "Return user name instead of computer name" bit for applications that use the computer name as a unique identifier. This returns the user's name to the application and gives a unique identifier to each user of the application.

Use the "Disable registry mapping for this application" bit to retain only one global copy of the registry variables that are used by the application.

If the "Do not substitute user Windows directory" bit is set, it retains the SystemRoot directory for GetWindowsDirectory API calls. If this bit is not set, all paths to the Windows directory are replaced with the path to the user's Windows directory.

.Ini Files
The following compatibility bits control .ini file propagation. They are located in the following registry subkey (where  is the name of the .ini file):

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Terminal Server\Compatibility\IniFiles\ 

Compatibility Bits

 * Windows 16-bit application: 0x00000004
 * Windows 32-bit application: 0x00000008
 * Synchronize user .ini file to system version: 0x00000040
 * Do not substitute user Windows directory: 0x00000080

If the "Synchronize user .ini file to system version" bit is set, it adds new entries from the system master .ini file when the application is started, but it does not delete any existing data in the user's .ini file. If this bit is not set, it overwrites the user's .ini file if it is older than the system master .ini file.

If the "Do not substitute user Windows directory" bit is set, it retains the SystemRoot directory for file paths in the .ini file when the system master version of the .ini file is copied to the user's Windows directory. If this bit is not set, it replaces all paths to the Windows directory with the path to the user's Windows directory.

Registry Paths
The following compatibility bits control registry propagation. They are located in the following registry subkey (where  is the registry path under the key HKEY_CURRENT_USER\Software):

HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Terminal Server\Compatibility\RegistryEntries\ 

Compatibility Bits

 * Windows 32-bit application: 0x00000008
 * Disable registry mapping for application: 0x00000100

If the "Disable registry mapping for application" bit is set, it adds new entries from the system master registry image when the application is started, but it does not delete any existing data in the user's registry. If this bit is not set, it deletes and overwrites the user's registry data if it is older than the system master registry data.

For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

186514 Terminal Server does not support sentinel devices

Additional query words: TWAIN Terminal Server Terminal Service

Keywords: kbpubtypekc kbmsccsearch kbinfo KB186499

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.