This documentation is archived and is not being maintained.

PrintSystemDesiredAccess Enumeration

Specifies the different access rights (or levels of access) for printing objects.

Namespace:  System.Printing
Assembly:  System.Printing (in System.Printing.dll)

public enum PrintSystemDesiredAccess

Member nameDescription
AdministratePrinterThe right to perform all administrative tasks for the print queue, including the right to pause and resume any print job; and the right to delete all jobs from the queue. This access level also includes all rights under UsePrinter.
UsePrinterThe right to add print jobs to the queue and to delete and enumerate one's own jobs.
EnumerateServerThe right to list the queues on the print server.
AdministrateServerThe right to perform all administrative tasks for the print server. This access level does not include AdministratePrinter rights for the print queues hosted by the server.
NoneNo access.

The access rights that are available at each level of access vary according to the following:

  • Whether the print server is a computer or a print server appliance.

  • The operating system that is used.

  • The security updates that are installed.

  • The security policies that are supported.

For this reason, access right descriptions in the "Members" section are typical of the rights that will correspond to each access level, but the access levels listed may provide more or fewer rights on particular systems.

These values are primarily used as parameters for PrintServer and PrintQueue constructors. The constructors will throw exceptions if you use a value that can apply only to another kind of object. For example, do not pass PrintSystemDesiredAccess.AdministratePrinter to a PrintServer constructor.

The following example shows how to use this enumeration to install a second printer that differs in its properties from an existing printer only in location, port, and shared status.

LocalPrintServer myLocalPrintServer = new LocalPrintServer(PrintSystemDesiredAccess.AdministrateServer);
PrintQueue sourcePrintQueue = myLocalPrintServer.DefaultPrintQueue;
PrintPropertyDictionary myPrintProperties = sourcePrintQueue.PropertiesCollection;

// Share the new printer using Remove/Add methods
PrintBooleanProperty shared = new PrintBooleanProperty("IsShared", true);
myPrintProperties.Add("IsShared", shared);

// Give the new printer its share name using SetProperty method
PrintStringProperty theShareName = new PrintStringProperty("ShareName", "\"Son of " + sourcePrintQueue.Name +"\"");
myPrintProperties.SetProperty("ShareName", theShareName);

// Specify the physical location of the new printer using Remove/Add methods
PrintStringProperty theLocation = new PrintStringProperty("Location", "the supply room");
myPrintProperties.Add("Location", theLocation);

// Specify the port for the new printer
String[] port = new String[] { "COM1:" };

// Install the new printer on the local print server
PrintQueue clonedPrinter = myLocalPrintServer.InstallPrintQueue("My clone of " + sourcePrintQueue.Name, "Xerox WCP 35 PS", port, "WinPrint", myPrintProperties);

// Report outcome
Console.WriteLine("{0} in {1} has been installed and shared as {2}", clonedPrinter.Name, clonedPrinter.Location, clonedPrinter.ShareName);
Console.WriteLine("Press Return to continue ...");

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0