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
public enum PrintSystemDesiredAccess
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
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. 
EnumerateServerThe right to list the queues on the print server. 
NoneNo access. 
UsePrinterThe right to add print jobs to the queue and to delete and enumerate one's own jobs. 

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 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 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0

Community Additions