[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETADDSET()
 Adds a bindery object to a set property
------------------------------------------------------------------------------
 Syntax

     NNETADDSET(<cObjName>,[<nType>],<cPropName>,<cMember>,
        [<cMemberType>],[<cServer>|<nConId>]) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cObjName>  Designates the name of the bindery object that is
     processed.

     <nType>  Designates a numeric value that indicates the type of
     <cObjName>.  The header file CTNNET.CH contains symbolic constants for
     the object types defined by Novell for use with the bindery functions of
     CA-Clipper Tools.  The default value indicates the object type OBJ_USER.

     <cPropName>  Designates the name of the set property of <cObjName>.

     <cMember>  Designates the name of the bindery object that is stored
     in the property <cPropName> of the bindery object <cObjName>.

     <cMemberType>  Designates a numeric value that indicates the type of
     <cMember>.  The default value indicates the object type OBJ_USER.

     <cServer>  Designates the name of the file server that contains the
     bindery that is accessed.  Your workstation must be attached to
     <cServer>.

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

 Returns

     NNETADDSET() returns .T. if the bindery object has been added
     successfully.  If an error occurs, the Novell error code can be queried
     with the NNETERROR() function.

 Description

     Important!  NNETADDSET() is a low level bindery function and should
     be used only with extensive knowledge of the bindery concept and the
     Novell API.

     NOVELL NET ADD BINDERY OBJECT TO SET
     Internally, Novell Netware differentiates between two possible property
     types: item and set property.  The function NNETADDSET() allows the
     storage of information to a set property.  Set properties contain a list
     of references to other bindery objects.  For example, the GROUP_MEMBERS
     property contains a list of users that are members of a user group.

     The parameters <cObjName> and <nType> describe the object that is
     processed.  <cPropName> is the name of the property.  The property must
     have been created before (for example, with the NNETCRTPRP() function).
     <cMember> and <cMemberType> specify the bindery object that is added to
     <cPropName>.  By passing the parameters <cServer> or <nConId>, it is
     possible to access the bindery of any connected file server.  The
     connection ID of a server can be determined with the functions
     NNETATTACH() or NNETLOGIN().

     Prerequisites for a successful call of NNETADDSET() are sufficient
     bindery and property access rights.  The necessary property access
     rights depend on the property security of the property that is
     manipulated.  For efficiency reasons, user defined object types must be
     passed in the high-low format.

 Examples

     .  Add user MIKE to the MARKET group :

        #include "ctnnet.ch"

        IF NNETADDSET('MARKET',OBJ_GROUP,'GROUP_MEMBERS','MIKE')
        ? 'User added successfully!'
        ELSE
        ? 'No user added!'
        ENDIF

     .  To add a user to a group, it is also necessary to add the
        group to two user properties.  Use NNETADDGRP() when adding a user to
        a group.

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