[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETADDGRP()
 Adds one or more users to a group
------------------------------------------------------------------------------
 Syntax

     NNETADDGRP(<cGroup>,<cUser>|<aUser>,
        [,<cServer>|<nConId>) --> nNumber

     Netware: 2.2 and 3.11

 Arguments

     <cGroup>  Designates the name of the group to which <cUser>|<aUser>
     is added.

     <cUser>  Designates the name of the user that is added to <cGroup>.

     <aUser>  Designates a number of elements of the type string.  Each
     element is the name of a user that is added to <cGroup>.

     <cServer>  Designates the name of the file server.  Your workstation
     must be attached to <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETADDGRP() returns the number of users successfully added to <cGroup>.
     If no user could be added, the function returns 0.

 Description

     NOVELL NET ADD USER TO GROUP
     With NNETADDGRP(), one or more users can be added to an existing group.
     To add one user, the login name of the user must be passed as the single
     argument, <cUser>.  More users can be added by passing the array,
     <aUser>, that contains the user names as elements.  As a member of a
     group, users automatically inherit the group privileges.  By passing
     <cServer> or <nConId>, the operation can be executed on any connected
     file server.  The connection ID of a file server can be determined with
     the functions NNETATTACH() or NNETLOGIN().

     Supervisior rights are necessary to add a user to a group.

 Note

     .  NNETADDGRP() is a high level function based on the low level
        functions for bindery access.  The CA-Clipper source code can be
        found on the product disks.

 Examples

     .  Add user MIKE to the TECH group:

        IF NNETADDGRP('TECH','MIKE')>0
        ? 'User added successfully!'
        ELSE
        ? 'No user added!'
        ENDIF

     .  Add users PAUL, JIM, and STEPHEN to the group TOOLS:

        NNETADDGRP('TOOLS',{'PAUL','JIM','STEPHEN'})

See Also: NNETCRTGRP() NNETREMGRP()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson