2.2 Message Syntax

Messages exchanged in the Group Policy: Deployed Printer Connections Extension allow:

  • The client-side plug-in to discover settings in the GPOs that indicate that the clients SHOULD<4> add printer connections to the user's computer.

  • The administrative tool plug-in to query a GPO for a list of printer connection settings.

  • The administrative tool plug-in to create and delete printer connection settings on the domain controller (DC).

The Deployed Printer Connections administrative tool plug-in MUST store data in an msPrint-ConnectionPolicy Active Directory object as specified in [MS-ADSC] section 2.171. The Active Directory object MUST be contained in the GPO.

msPrint-ConnectionPolicy objects MUST have the following attributes, as specified in [MS-ADA3] sections 2.331, 2.130, 2.241, and 2.124, respectively.

 Attribute

 Value

uNCName

The value of this attribute MUST be a directory string that specifies the full connection name, and it MUST consist of the server and printer names, as specified in the Universal Naming Convention (UNC), in the form \\server name\printer name.

printerName

The value of this attribute MUST be a directory string that specifies the printer name part of the uNCName attribute in the format specified in [MS-RPRN], section 2.2.4.14.

serverName

The value of this attribute MUST be a directory string that specifies the server name part of the uNCName attribute in the format specified in [MS-RPRN], section 2.2.4.16.

printAttributes

The value of this attribute SHOULD be zero, and any value of this attribute MUST be ignored during policy application.

msPrint-ConnectionPolicy objects MUST be created in one of the following locations in the Active Directory where <x>, <y>, <z> is the fully qualified domain name (FQDN)  of the domain/LDAP server and <GPO_GUID> is the GUID of the GPO that is being queried or updated.

  • Printer connection settings in the User section of the GPO MUST use this location:

    CN=PushedPrinterConnections, CN=User, CN=<GPO_GUID>, CN=Policies, CN=System, DC=<x>, DC=<y>, DC=<z>

  • Printer connection settings in the Machine section of the GPO MUST use this location:

    CN=PushedPrinterConnections, CN=Machine, CN=<GPO_GUID>, CN=Policies, CN=System, DC=<x>, DC=<y>, DC=<z>

The messages that are used by this protocol perform the following functions:

  • Printer connection setting creation

  • Printer connection setting deletion

  • Printer connection setting retrieval

Unless specified otherwise, the format used for GUID values in this protocol is the curly-braced string representation ([MS-DTYP] section 2.3.4.3).