docs-xml/smbdotconf/printing/showaddprinterwizard.xml

   1 <samba:parameter name="show add printer wizard"
   2                  context="G"
   3                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>With the introduction of MS-RPC based printing support
   7     for Windows NT/2000 client in Samba 2.2, a &quot;Printers...&quot; folder will
   8     appear on Samba hosts in the share listing.  Normally this folder will
   9     contain an icon for the MS Add Printer Wizard (APW).  However, it is
  10     possible to disable this feature regardless of the level of privilege
  11     of the connected user.</para>
  12
  13     <para>Under normal circumstances, the Windows NT/2000 client will
  14     open a handle on the printer server with OpenPrinterEx() asking for
  15     Administrator privileges.  If the user does not have administrative
  16     access on the print server (i.e is not root or has granted the
  17     SePrintOperatorPrivilege), the OpenPrinterEx()
  18     call fails and the client makes another open call with a request for
  19     a lower privilege level.  This should succeed, however the APW
  20     icon will not be displayed.</para>
  21
  22     <para>Disabling the <parameter moreinfo="none">show add printer wizard</parameter>
  23     parameter will always cause the OpenPrinterEx() on the server
  24         to fail.  Thus the APW icon will never be displayed.
  25 </para>
  26 <note><para>This does not prevent the same user from having
  27                 administrative privilege on an individual printer.</para></note>
  28 </description>
  29
  30 <related>addprinter command</related>
  31 <related>deleteprinter command</related>
  32
  33 <value type="default">yes</value>
  34 </samba:parameter>