Printer-Related Policy Registry Values

Summary

When troubleshooting printer settings set through a policy in Presentation Server 4.0 it is important to investigate the three steps involved in applying a particular policy (configuration, resolution, and enforcement). This document is a reference for the registry values that are written during policy resolution for printer-related policy rules.

Background

In regards to polices configured in Presentation Server, there are three major steps:

Configuration: This is the creation or modification of policy settings through the Presentation Server Console.
Resolution: This is when all configured polices are evaluated according to the filter criteria for which a particular session falls under and a single resultant policy is written to the registry for that session.

In Presentation Server 4.0 there are five possible filter criteria:

Access Control: Whether or not the connection is tunneling through an Access Gateway device and additional Access Gateway specific filters
Client IP Address: The IP address of the client connection
Client Name: The client name of the client machine
Servers: The server where the session is established
Users: The user name (or group membership) of the user who created the session

The single, resultant policy, is written to the server’s registry under:

HKEY_LOCAL_MACHINE\Software\Citrix\Polices\SessionID\

Where SessionID is the sessionID of the client’s connection.

Enforcement: This is when an action is taken based on the resolved policy. For printing-related polices, this is done by the Citrix Print Manager Service at connection time.

List Format

The format of the following list of printer-related policy registry values is as follows:

Folder > Subfolder (if applicable) as displayed in the Presentation Server Console

A. Rule name as displayed in the Presentation Server Console (name of the registry key under \SessionID where the value is written) (The name of the rule value as written to the registry).
The rule name value can have the following values:

• Enabled: 0x0

• Disabled: 0x1

B. Rule value as displayed in the Presentation Server Console: The name of the registry value and its hexadecimal value.

Printer-Related Policy Registry Values

Below is a list of all printer-related policy settings that can be set from the Presentation Server 4.0 Management Console.

Under Printing > Client Printers:

Autocreation (written under LogonSettings key) (ConnectClientPrinterAtLogon):

Autocreate all client printers:
ConnectClientPrinterAtLogon__Flag: 0x80 hex
Autocreate local (non-network) client printers only:
ConnectClientPrinterAtLogon__Flag: 0x82 hex
Autocreate the client's default printer only:
ConnectClientPrinterAtLogon__Flag: 0x81 hex
Do not autocreate client printers:
ConnectClientPrinterAtLogon__Flag: 0x84 hex

Legacy client printers (written under Printer key) (LegacyClientPrinters):

Create dynamic session-private client printers:
LegacyClientPrinters_TurnOn: 0x1
Create old-style client printers:
LegacyClientPrinters_TurnOn: 0

Printer properties retention (written under Printer key) (ModifiedPrinterProperties):

Saved on the client device only:
ModifiedPrinterProperties__WriteMethod: 0x0
Retained in user profile only:
ModifiedPrinterProperties__WriteMethod: 0x1
Held in profile only if not saved on client:
ModifiedPrinterProperties__WriteMethod: 0x2

Print job routing (written under Printer key) (ClientPrintingForNetworkPrinter):

Connect directly to network print server if possible:
ClientPrintingForNetworkPrinter_TurnOn: 0x1
Always connect indirectly as a client printer:
ClientPrintingForNetworkPrinter_TurnOn: 0x0

Turn off client printer mapping (written under Virtual Channels key) (DisableClientPrinterMapping):

Turn off client printer mapping (enabled is the only setting):
DisableClientPrinterMapping: 0x0

Under Printing > Drivers:

Native printer driver autoinstall (written under Printer key) (PrintDriverAutoInstall):

Native printer driver autoinstall:
PrintDriverAutoInstall__TurnOn: 0x1
Do not automatically install drivers:
PrintDriverAutoInstall__TurnOn: 0x0

Universal driver (written under Printer key) (ClientPrintDriverToUse):

Use the universal driver only if requested driver is unavailable:
ClientPrintDriverToUse__Selection: 0x0
Use only printer model-specific drivers:
ClientPrintDriverToUse__Selection: 0x1
Use universal driver only:
ClientPrintDriverToUse__Selection: 0x2

Under Printing-> Session Printers:

Choose client’s default printer (written under Logon Setting key) (DefaultToMainClientPrinter):

Set default printer to the client's main printer:
DefaultToMainClientPrinter_TurnOn: 0x1
Do not adjust the user's default printer:
DefaultToMainClientPrinter_TurnOn: 0x0
Set the default to an assigned network printer:
DefaultToMainClientPrinter_NetworkDefault:
Note: This lists the unique identifier (UID) of a printer connection object (see the How to Identify the Name of a Network Printer Share from its UID section below).

Network Printers to Connect at Logon (written under Logon Setting key) (DefaultToMainClientPrinter):

All assigned network printers for a particular session:
DefaultToMainClientPrinter_Printers:
Note: This lists the UIDs of all assigned network printers for a particular session (see the How to Identify the Name of a Network Printer Share from its UID section below).

How to Identify the Name of a Network Printer Share from its UID

Consider the following scenario, where there is a policy that assigns two network printers, one of which is set to be the default printer:

\\ftlrnickvdc01\test1

\\ftlrnickvdc01\9500 – set to be the client’s default printer

These settings are reflected in the registry under when a session is established:

HKEY_LOCAL_MACHINE\Software\Citrix\Polices\<SessionID>\LogonSetting.

There are two important values under this key:

DefaultToMainClientPrinter_Printers lists the UID of each assigned network printer for the session.

DefaultToMainClientPrinter_NetworkDefault lists the UID of the printer that is to be set as default inside the session. It is also included in DefaultToMainClientPrinter_Printers.

In order to match these UIDs to a readable name in the format \\PrintServerName\PrinterShareName, the CTX106232 – DSView utility is necessary. This can be found in the \support\debug folder of the Presentation Server 4.0 installation media.

Depending on which printer you are looking for information on, you can use DSView to navigate to the following area:

ServerNeighborhoods\<FarmName>\PrinterRoot\PrinterConnection\<UID from DefaultToMainClientPrinter__NetworkDefault or DefaultToMainClientPrinter__Printers>

Each printer connection entry has a value for PrinterUID in little-endian order (read from right to left). For example, the number from the above printer connection object (“83 3 0 0 2d 0 81 6e”) would be converted to “6e 81 02d 0 0 383.”

Each printer UID is listed in DSView under ServerNeighborhoods\<FarmName>\PrinterRoot\Printers

Under the Printers object, you can find the print server name in the ServerName value and the printer’s shared name in the ShareName value:

For this example, the default printer is being set to the \\FTLRNICKVDC01\test1 printer.