docs/docbook/smbdotconf/printing/showaddprinterwizard.xml

   1 <samba:parameter name="show add printer wizard"
   2                  context="G"
   3                  advanced="1" developer="1"
   4                  xmlns:samba="http://samba.org/common">
   5 <listitem>
   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 a member of the
  17     <parameter moreinfo="none">printer admin</parameter> group), 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. <emphasis>
  25     Note :</emphasis>This does not prevent the same user from having
  26     administrative privilege on an individual printer.</para>
  27
  28     <para>See also <link linkend="ADDPRINTERCOMMAND"><parameter moreinfo="none">addprinter
  29     command</parameter></link>, <link linkend="DELETEPRINTERCOMMAND">
  30     <parameter moreinfo="none">deleteprinter command</parameter></link>, <link linkend="PRINTERADMIN">
  31     <parameter moreinfo="none">printer admin</parameter></link></para>
  32
  33     <para>Default :<command moreinfo="none">show add printer wizard = yes</command></para>
  34 </listitem>
  35 </samba:parameter>