docs-xml/smbdotconf/printing/showaddprinterwizard.xml

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