Error DataBase-One Place all Solutions Forums Blog Glossary    Contact Us
Search  
   
Browse by Category
Error DataBase-One Place all Solutions .: Citrix .: How to configure Seemless settings

How to configure Seemless settings

Summary

This document outlines currently available server-side Registry settings that can be used to control specific Seamless session functionality. This includes controlling the interaction and display of specified application windows as well as settings with the Seamless environment itself.

Under most circumstances, the default server settings will suffice for the majority of applications. This facility allows an administrator to have a more granular control over Seamless sessions that may be required with some applications and/or in some deployments.

There are three sections:

Seamless Global Registry Flags

Seamless Per Application Window Registry Flags

Additional Seamless Registry Settings

Each setting has a required Citrix platform version and patch level in order for the setting to be available.

Note: The contents of this document are subject to change at any time. This document is updated when new settings become available or are modified.

Creating a .Reg File

If a registry flag needs to be created on many servers, it might be worthwhile to create it first on one server, then export the registry key as a .Reg file which can then be easily distributed to the other servers. To export a .Reg file from the Regedit File menu, select Export.

Caution! This fix requires you to edit the registry. Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Seamless Global Registry Flags

These values affect all Seamless connections to a server.

To configure a Global Seamless Flag, create the value SeamlessFlags, and then specify a Value corresponding to one or more of the choices listed below:

Registry Key: HKEY_LOCAL_MACHINE/System/CurrentControlSet/Control/Citrix/wfshell/TWI
Value Name:
SeamlessFlags
Value Type:
REG_DWORD
Values:
Flags 1 through 19 below

If more than one of these flags is needed at the same time, add them together as in the following examples:

 

Note: All values are in Hex format.

Example 1: To use Flags 1 and 8 below, the Hex value for SeamlessFlags would be 0x1 + 0x200 = 0x201.

Example 2: To use Flags 1, 8, and 9 below, the Hex value for SeamlessFlags would be 0x1+0x200+0x400 = 0x601.

Example 3: To use Flags 5 and 6 below, the Hex value for SeamlessFlags would be 0x20 + 0x80 = 0xA0.

Adding Global Seamless Exception Flags Graphic

1.

DISABLE SESSION SHARING

 

Value: 0x1

 

Explanation: Determines if each Seamless connection to the server uses Session Sharing. Use this Flag to Disable Session Sharing. Without this Registry Value set, or setting this value to 0x0 enables Session Sharing.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

2.

DISABLE MODALITY CHECK

 

Value: 0x2

 

Explanation: Specifies that the ICA client will not perform a Modality check. The owner window of a Modal Dialog can be moved, although input focus will remain on the Modal Dialog. This is useful when running an application such as PaintShop Pro Version 6 in a Seamless session. Without this Registry Value set, or setting this value to 0x0 specifies that the ICA client will perform a Modality check on Seamless windows.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

3.

DISABLE ACTIVE ACCESSIBILITY HOOK

 

Value: 0x4

 

Explanation: Determines if the Seamless Engine will load its Active Accessibility hook in a Seamless session. By default the Seamless Engine uses a technique called event hooking to monitor any changes made to an application’s windows on the server and sends these changes to the ICA Client. Wfshell.exe loads the DLL, sehook20.dll. Without this Registry Value set, or setting this value to 0x0 specifies that Active Accessibility is enabled.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

4.

ENABLE COLOR SYNC

 

Value: 0x10

 

Explanation: Specifies that the Seamless session will inherit the client system color settings. This may cause problems with some applications when the color scheme used on the client is not fully supported by the server. Without this Registry Value set, or setting this value to 0x0 specifies that the Seamless session will not inherit the client system color settings.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

5.

DISABLE SYSTRAY AGENT

 

Value: 0x20

 

Explanation: Specifies that the System Tray agent in a Seamless session will not be created. The System Tray agent allows an application that uses the System Tray, using the Shell_NotifyIcon API, to be sent to the ICA client’s System Tray. Without this Registry Value set, or setting this value to 0x0 specifies that System Tray agent in a Seamless session will be created.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

6.

DISABLE ICONIC WINDOWS

 

Value: 0x80

 

Explanation: Specifies that iconic windows will not be sent to the ICA client. This may improve performance slightly, however setting it can cause problems with applications such as MS Office when run in a Seamless session. For example, the application’s icon may not be visible when it is minimized on the local Client Taskbar. Without this Registry Value set, or setting this value to 0x0, specifies that iconic windows are sent to the ICA client.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

7.

DISABLE LOAD CHECK

 

Value: 0x100

 

Explanation: By default Load Balancing takes precedence over Session Sharing on a fully loaded server. New connections are routed to other less busy servers, rather than have their sessions shared with existing connections. Setting this Flag along with the required updates listed below, will allow session sharing of connections on fully loaded servers. Without this Registry Value set, or setting this value to 0x0, will retain the default Load Balancing behavior.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

8.

DISABLE WM_QUERYDRAGICON MESSAGES

 

Value: 0x200

 

Explanation: Specifies that the Seamless engine will not send WM_QUERYDRAGICON messages to application windows to obtain the Icons associated with them. Without this Registry Value set, or setting this value to 0x0, the Seamless engine will send these messages to application windows to get the Icons associated with them.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

9.

FORCE RAW MOUSE EVENTS TO SERVER

 

Value: 0x400

 

Explanation: Specifies that the ICA client will send raw mouse event messages to the server. This is useful, when running an application developed using the Borland IDE, which allows the creation of dialog boxes that behave like a modal dialog box, but its parent window still responds to certain types of window messages, like WM_SETFOCUS. Without this Registry Value set, or setting this value to 0x0, specifies that the ICA client will send regular translated mouse event messages to the server.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

10.

DISABLE FULL WINDOW DRAG

 

Value: 0x800

 

Explanation: Specifies that the Windows feature "Full Window Drag" can be disabled. This may be necessary for some non-standard applications. Without this Registry Value set, or setting this value to 0x0, specifies this Windows feature is enabled.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

11.

FORCE MENU WINDOW TO HAVE OWNER

 

Value: 0x1000

 

Explanation: Specifies that Menu Windows will always be re-created on the ICA client with an owner window.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

12.

DISABLE SHELL HOOK AGENT

 

Value: 0x2000

 

Explanation: Instant Messenger type programs commonly use the FlashWindow() API to flash the taskbar button to alert users of incoming messages. After applying the updates listed below in the 'Required' section, support for the FlashWindow() API is added and turned on by default.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

13.

DISABLE CLIENT INFO SYNC

 

Value: 0x4000

 

Explanation: Some custom applications that did not display properly when running on Windows XP/2000 with the Windows XP Theme enabled, sometimes experienced the same behavior when running as a seamless application on MetaFrame XP Feature Release 3 on Windows 20003 that does not have the Windows XP Theme enabled. For example, the title bar of the application is larger in height.

Starting with MetaFrame XP Feature Release 3 for Windows 2000/2003, the server seamless engine has extended support for certain window style properties of the workstation where the seamless application is running; for example, the styles generated by Windows XP Themes.

This new seamless global registry flag, when set, instructs the server-side seamless engine not to read certain client workstation window style information.

Set this registry flag to instruct the server seamless engine not to synchronize with the client's window style that pertains to those representative of the Windows XP Theme:

Custom applications that do not display properly when running on Windows XP/2000 with the Windows XP Theme enabled can be run in a seamless session from a workstation that has the Windows XP Theme enabled and be displayed using the Windows Classic style.

Additionally, when setting this Flag, extended data about the client side Desktop is not used in a Seamless session, including the size of the local Desktop Work Area. As a result, when minimizing some applications run in a Seamless session, they may minimize to the local Desktop above the Taskbar or overlap it. The reason for this is that the size and position of the Local Taskbar is not being sent to the Server session, therefore, these metrics are not being used when the calculations are made on where on the Desktop the application is to be minimized to.

If it is necessary to set this flag to disable client desktop information from being sent to the server but still send the client work area information, then do not use this Flag, instead use DISABLE CLIENT INFO SYNC EXCEPT WORKAREA,0x80000 as documented below.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

14.

DON’T SEND DISABLE

 

Value: 0x8000

 

Explanation: Setting this Flag reverses the behavior introduced in version 8.0 of the Win32 ICA client for Seamless connections of sending the WS_DISABLED Window Style to the client. Supporting this Window Style would cause a small number of custom applications to lose focus to a local application window running on the workstation when the Seamless Application would set this Window Style and also have an invisible window in the background. The reason for introducing the ability to send the WS_DISABLE window style to the client was to support the implementation of Seamless application windows responding to the “Minimize All” or “Show Desktop” feature on Windows workstations. Therefore, setting this Flag has an affect on how Seamless Windows will respond to the windows messages sent by using the “Minimize All” or “Show Desktop” feature.

Support for this Seamless Flag can only be activated by applying both a Win32 client and Server update that support it. See the following requirements.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
MPSE300W2KR05
MPSE300W2K3R05
PSE400W2KR02
PSE400W2K3R02
None
None

 

Required Client: Presentation Server Client for 32-bit Windows, Version 9.200 or later

15.

DO NOT SEND OFF SCREEN WINDOWS

 

Value: 0x20000

 

Explanation: Starting with Citrix Presentation Server 4.0, windows that are created outside of the visible client desktop area are sent to the client. Set this Flag for custom applications that experience focus or Z-Order related issues when running them in a Seamless session.

 

Supported Platforms and Required Hotfixes:

 

   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

PSE400W2KR02
PSE400W2K3R02
PSE400W2K3X64034
None
None

16.

DISABLE LANGUAGE BAR AGENT

 

Value: 0x40000

 

Explanation: Starting with Citrix Presentation Server 4.5, when using a Language Bar (for example for IME) in an ICA Seamless session, minimizing the Language Bar displays an icon in the local Systray, as opposed to a minimized Window above the local Taskbar as seen in earlier Presentation Server versions. Set this flag to disable the Language Bar Systray Support in Presentation Server 4.5 or later only for troubleshooting purposes, as it will revert the behavior to prior versions, whereby once the Language Bar is minimized, the window cannot be restored.

 

Supported Platforms and Required Hotfixes:

 

Citrix Presentation Server 4.5 for Windows 2003
    Citrix Presentation Server 4.5 for Windows 2003 x64

None
None

17.

DISABLE CLIENT INFO SYNC EXCEPT WORKAREA

 

Value: 0x80000

 

Explanation: Use this flag to configure the server seamless engine to accept the client work area information (size of the desktop excluding the taskbar) but not other client metrics, such as desktop themes and font information as described above for DISABLE CLIENT INFO SYNC, 0x4000.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104R02W2K016 (limited availability)
XE104R02W2K3016 (limited availability)
PSE400W2KR02
PSE400W2K3R02
PSE400W2K3X64034
None
None

18.

DISABLE CLIENT INFO SYNC EXCEPT CODEPAGE

 

Value: 0x100000

 

Explanation: When setting either of the Global Seamless Flags to disable client information synchronization (0x4000 or 0x80000), and the text in the title bar of seamless published applications contains characters that are not part of the ANSI character set, the characters might not display correctly.

 

Supported Platforms and Required Hotfixes:

 

   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

PSE400R02W2K028
PSE400R02W2K3040
None
None

19.

Allow AA Hook to handle Hide Events

 

Value: 0x200000

 

Explanation: Use this flag to allow the Server side Seamless component to send any Hide events requested by an application to the client. This may be required when certain applications generate a Hide event prior to a Show event. This Flag also replaces client Fix# 144841, included in Presentation Server for Windows Clients versions 10.100 and earlier, where the Taskbar icon for a Seamless application may not display when the application is minimized or docked.

NOTE: Setting this Flag does not work if the Flag to disable the ACTIVE ACCESSIBILITY HOOK is set (Global Flag 0x4).

 

Supported Platforms and Required Hotfixes:

 

   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

None
PSE400R03W2K3077
PSE450R01W2K3006
None

20.

JOB OBJECT

 

Explanation: If a published application was a program that created a new process and then terminated itself, the published application appeared in the Management Console for MetaFrame XP. However, in a seamless session the application was launched through session sharing, the application appeared in the Management Console but then disappeared.

By default, the thread that checks the process cares about only the first instance of the launched process. The thread regarded the published application as terminated when the first instance of the process was terminated even if that process created a separate process.

This update provides a way to configure those published applications to use the JOB object so that additional processes created by the initial process are considered as published applications.

For this update to work properly, you need to perform the following steps.

If the command line of the published application is [ApplicationPath], go to the following Registry key and make changes as necessary:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI\StartInJobObject
Key Value: [ApplicationPath]
Type: DWORD
Value: 0

For example, if the command line specified for the published application is c:\notepad.cmd, go to the following Registry key and make changes as necessary:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI\StartInJobObject
Key Value: c:\notepad.cmd
Type: DWORD
Value: 0

For those applications whose command line is specified in the StartInJobObject key, the published application will not disappear from the Management Console until all of the processes created by the process are terminated.

 

Supported Platforms and Required Hotfixes:

   

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

21.

WORKER WAIT INTERVAL

 

Explanation: This update addresses a custom application's performance when run seamlessly. Some applications appeared to be slower to respond when performing actions such as moving, resizing, or closing windows. This fix introduces two new registry settings that allow administrators to configure an explicit time interval for the seamless engine mechanism to monitor when changes take place in the seamless applications.

Create the following two registry keys:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
Value Name: WorkerWaitInterval
Type: REG_DWORD
Value: <Number of milliseconds allowed> (Values are between 5 – 500; the default is 50.)

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\wfshell\TWI
Value Name: WorkerFullCheckInterval
Type: REG_DWORD
Value: <Number of milliseconds allowed> (Values are between 50 – 5000; the default is 500.)

For both values, a larger size slows responsiveness but improves scalability; a smaller size increases responsiveness but decreases scalability slightly. The level of scalability depends on several factors, such as hardware sizing, types of applications, network performance, and number of users.

 

Supported Platforms and Required Hotfixes:

   

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
MPSE300W2KR05
MPSE300W2K3R05
None
None
None
None
None

Seamless Per Application Window Registry Flags

These values affect only the specified application window for any instance of the application when connected through a Seamless connection.

To configure a Per Application Window Seamless Flag, it is first necessary to determine the Window Class Name of the target window. To determine the Class Name of a window, use the WindowHistory tool from the Citrix Knowledge Center or SPY++ from Microsoft Visual Studio. Refer to the following articles:

• CTX106985 – WindowHistory 4.0 for 32-bit platforms

• CTX109235 – WindowHistory64 4.0 for x64 platforms

• CTX103137 – Using Spy++ to Discover a Window Class Name

• CTX107187 – Using SpeedScreen Latency Reduction Manager to Discover a Window Class Name

Once the Window Class Name has been identified, follow the steps below.

Steps to Add Per Application Window Registry Flags:

    a. Run Regedit.

    b. Go to HKEY_LOCAL_MACHINE/System/CurrentControlSet/Control/Citrix/wfshell/TWI.

    c. Highlight the TWI Key, then from the Edit Menu select New > Key.

    d. Enter <WindowClassName> for the Key Name.
    Note
    : Replace <WindowClassName> with actual Window Class Name identified earlier using a third-party utility. In the screen shot example below, the Window Class Name is ToolbarWindow32.

    e. Highlight the newly created <WindowClassName> subkey.

    f. From the Edit menu, select New, then String value.

    g. Enter the word ClassName for the Value Name.

    h. Double-click ClassName and enter <WindowClassName> for the Value data.

    i. Highlight <WindowClassName> in the left pane.

    j. From the Edit menu, select New, then DWORD value.

    k. Enter the word Type for the Value Name.

    l. Double-click Type and enter <Hex number for the Exception Flag> for the Value data.

Registry Key: HKEY_LOCAL_MACHINE/System/CurrentControlSet/Control/Citrix/wfshell/TWI/<WindowClassName>
Value Name1:
ClassName
Value Type1:
REG_SZ
Value1:
<WindowClassName>
Value Name2:
Type
Value Type2:
REG_DWORD
Value2:
See Hexadecimal Values 1 through 8 below

If more than one of these flags is needed for a given window at the same time, add them together as in the following example:

 

Note: All values are in Hex format.

Example: To use Flags 1 and 2 below, add 0x8 + 0x10 = 0x18.

Adding Specific Window Seamless Exception Flags Graphic

Adding Multiple Window Class Names under one Registry Setting

See CTX153088 - Seamless: Adding Multiple Window Class Names under one Registry Setting

1.

WINDOW ALWAYS VISIBLE

 

Value: 0x8

 

Explanation: For performance reasons, invisible windows that are created are not re-created on the ICA client. Setting this flag for a specified window enables it to be re-created on the ICA client.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

2.

WINDOW SIZE AND LOCATION NOT CHECKED

 

Value: 0x10

 

Explanation: For performance reasons, windows that are created with a Zero window size or created outside of the Desktop area, are not re-created on the ICA client. Setting this flag for such a specified window enables it to be re-created on the ICA client.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

3.

USE OWNER WINDOW INSTEAD OF PARENT

 

Value: 0x20

 

Explanation: Enabling this flag specifies that the Owner window of the window specified will be determined by using the GW_OWNER parameter instead of the GWL_HWNDPARENT parameter. This may be necessary if some application windows do not use the same window as both the Parent and Owner window.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

4.

USE GETPARENT API

 

Value: 0x40

 

Explanation: Setting this value to a window enables the Seamless engine to use the GetParent API to get the Owner of the specified window.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

5.

SET AS INDEPENDENT WINDOW

 

Value: 0x80

 

Explanation: Setting this value to a window enables the Seamless engine to send the specified window as an independent window (no parent, no owner).

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

6.

SEND NO ICON CHANGES

 

Value: 0x100

 

Explanation: Setting this value to a window enables the Seamless engine not to send WM_GETICON or WM_QUERYDRAGICON messages to the specified window. This may cause some applications to have a generic icon displayed on the Local ICA client Taskbar instead of its own.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

7.

DO NOT REQUEST SMALL ICON

 

Value: 0x200

 

Explanation: Setting this value to a window, will direct the Server Seamless Engine to not request the small Icon associated with that window. This may be needed for application windows that alternate between different Icons while running that are not displaying the different Icons when run Seamlessly.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2003 x64
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
None
None
None
None
None
None
None

8.

DO NOT SEND SPECIFIED ZERO-SIZED WINDOW TO THE CLIENT

 

Value: 0x400

 

Explanation: Setting this value to a window that is zero-sized (a window that has the coordinates 0,0), will direct the Server Seamless Engine to not send that window information to the client.

This setting may need to be used in the following scenario:

Sessions do not log off when a user closes all Published Applications in a session, one or more of which may be using zero-sized windows - even though all visible windows of the application(s) have been closed.

 

Supported Platforms and Required Hotfixes:

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   MetaFrame Presentation Server 3.0 for Windows 2000
   MetaFrame Presentation Server 3.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000
   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104W2KR02
XE104W2K3R02
MPSE300W2KR05
MPSE300W2K3R05
PSE400W2KR02
PSE400W2K3R02
None
None

Additional Seamless Registry Settings

This section lists additional settings that are not categorized in the sections above.

1.

MICROSOFT OFFICE APPLICATIONS SEAMLESS TASKBAR FUNCTIONALITY

 

Explanation: When using Microsoft Office Applications such as Excel, PowerPoint, Project and Access versions 2000-2003 on a MetaFrame XP or later server in a Seamless session, additional Taskbar Icons are not created on the local workstation Taskbar when creating new content in these applications – only a single Icon representing the application instance.

Each of these applications has an option that allows the display of additional Taskbar Icons named, “Windows in Taskbar”.

Support has been added in the updates listed below so that when running these Microsoft Office Applications in a Seamless session, and the option to add “Windows in Taskbar” is set, that additional Taskbar Icons are now created on the local workstation Taskbar when creating new content in these applications.

Create the following Registry key:

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\
Key Name: ExcelHook

Then add the following Value:

Path: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ExcelHook
Name: Enabled
Type: REG_DWORD
Data: 1

 

Supported Platforms and Required Hotfixes:

   

 

   MetaFrame XP 1.0 for Windows 2000
   MetaFrame XP 1.0 for Windows 2003
   Citrix Presentation Server 4.0 for Windows 2000

   Citrix Presentation Server 4.0 for Windows 2003

  Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

XE104R02W2K041 (limited availability)
XE104R02W2K3033 (limited availability)
Hotfix Rollup Pack 02 with PSE400R02W2K026 and PSE400R02W2K034
Hotfix Rollup Pack 02 with PSE400R02W2K3036 and PSE400R02W2K3053
None
None

 

Required Client: Presentation Server Client for 32-bit/64-bit Windows Version 9.200 or later

2.

SEAMLESS PUBLISHED TOOLBARS

 

Explanation: The desktop work area may not resize appropriately when a seamless published toolbar is docked.

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CtxHook\AppInit_Dlls\SHAppBar Hook

Then add the following Values:

Name: FilePathName
Type: REG_SZ
Data: shappbarhook.dll

Name: Flag
Type: REG_DWORD
Data: 4

Name: Settings
Type: REG_DWORD
Data: 1

 

Supported Platforms and Required Hotfixes:

   

 

   Citrix Presentation Server 4.0 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003
   Citrix Presentation Server 4.5 for Windows 2003 x64

Hotfix Rollup Pack 02 with PSE400R02W2K3007
None
None

 

Required Client: Presentation Server Client for 32-bit/64-bit Windows Version 9.230 or later


This document applies to:

  • Presentation Server 4.0 for Microsoft Windows 2003
  • MetaFrame XP 1.0 for Microsoft Windows 2000
  • Presentation Server 4.5 for Windows Server 2003
  • MetaFrame Presentation Server 3.0 for Microsoft Windows 2000
  • Presentation Server 4.0 for Microsoft Windows 2000
  • MetaFrame XP 1.0 for Microsoft Windows 2003
  • Windows (32/64 Bit)
  • Presentation Server 4.5 for Windows Server 2003 x64 Edition
  • MetaFrame Presentation Server 3.0 for Microsoft Windows 2003
  • Presentation Server 4.0 x64 Edition

How helpful was this article to you?

Related Articles

article How to Configure Time and Date Settings in Windows 2008 Server Core
Windows Server 2008 has an interesting...

(No rating)  3-26-2008    Views: 115   
article How to Import, export or delete registry settings
Import, export or delete registry settings...

(No rating)  3-7-2008    Views: 241   
article How to manage Windows 2008 Server Core Local Settings
A Server Core installation provides a minimal...

(No rating)  3-26-2008    Views: 117   

User Comments

Add Comment
No comments have been posted.