~zulcss/samba/server-dailies-3.4

« back to all changes in this revision

Viewing changes to docs-xml/smbdotconf/printing/showaddprinterwizard.xml

  • Committer: Chuck Short
  • Date: 2010-09-28 20:38:39 UTC
  • Revision ID: zulcss@ubuntu.com-20100928203839-pgjulytsi9ue63x1
Initial version

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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>