[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETINSET()
 Determines if a bindery object belongs to a set property
------------------------------------------------------------------------------
 Syntax

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

     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
     <cName>.  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.
     When you work with numeric values, you must take into account that, for
     efficiency reasons, NNETRDITM() expects the object type as an integer in
     the high-low format.

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

     <cMember>  Designates the name of the bindery object for which the
     membership in <cPropName> of <cObjName> is checked.

     <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 for which the
     bindery is accessed.  Your workstation must be attached to <cServer>.

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

 Returns

     NNETINSET() returns .T. if <cMember> belongs to the set property
     (<cPropName>) of the bindery object (<cObjName>).  If < cMember> does
     not belong to the set property (<cPropName>) the function returns .F..

 Description

     NOVELL NET OBJECT IN SET
     Internally, Novell Netware has defined two different property types:
     item and set properties.  A set property contains a list of references
     to other bindery objects.  An example is the GROUP_MEMBERS property that
     contains a list of users that are members of a user group.  With the
     function NNETINSET(), you can check to see if a bindery object,
     specified with the parameters <cMember> and <cMemberType>, belongs to
     the set property (<cPropName> of the bindery object (<cObjName> and
     <cType>).  With the parameters <cServer> or <nConId>, the bindery of any
     attached server can be accessed.  The connection ID of a server is
     returned by NNETATTACH() or NNETLOGIN().

 Example

     Check to see if user MIKE has supervisor rights:

     #include "ctnnet.ch"

     IF NNETINSET('MIKE',OBJ_USER,'SECURITY_EQUALS','SUPERVISOR',OBJ_USER)
     ? 'User has supervisor rights!'
     ELSE
     ? 'User has no supervisor rights!'
     ENDIF

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