docs: Fix typo.
[kai/samba-autobuild/.git] / 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 has granted the
18     SePrintOperatorPrivilege), 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
34 <value type="default">yes</value>
35 </samba:parameter>