[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETRDSET()
 Reads a set property
------------------------------------------------------------------------------
 Syntax

     NNETRDSET(<cObjName>,<nType>,<cPropName>,
        [<cServer|<nConId>]) --> aObjList

     Netware: 2.2 and 3.11

 Arguments

     <cObjName> Designates the name of the bindery objects that are
     processed.

     <nType>  Designates the object type of <cObjName>.  The header file
     CTNNET.CH contains symbolic constants for a number of object types.
     When working with numeric values, take into account that, for efficiency
     reasons, the function NNETRDSET() expects the object type in the high-
     low format.

     <cPropName>  Designates the name of the property that is processed.
     <cPropName> must describe a set property.

     <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

     NNETRDSET() returns a one-dimensional array that contains the object
     ID's of the bindery objects in <cPropName> as numeric values.

 Description

     NOVELL NET READ SET PROPERTY
     Internally, Novell Netware defines two property types:  item and set
     property.  With NNETRDSET(), the contents of a set property can be read.
     Set properties contain a list of object ID's.  An object ID has a length
     of four bytes and identifies a bindery object.  An example is the
     property GROUP_MEMBERS, which contains a list of users that are members
     of a group.

     NNNETRDSET() returns an array with the object ID's of the members of the
     set property <cPropName>.  With the functions NNETOBJNAM() and
     NNETOBJTYP(), object name and object type for the object ID can be
     determined.

     The function NNETRDSET() requires sufficient bindery and property access
     rights.  The necessary property access rights depend on the property
     security of the property that is read.

 Note

     .  For efficiency reasons, NNETRDSET() returns the object IDs in
        the high-low format (see the Introduction to this chapter).

 Example

     The SECURITY_EQUALS property contains a list of objects to which an
     object is security-equivalent.  This property is usually attached to
     user and user group objects.  Read the property SECURITY_EQUALS of user
     MIKE, and display the object names and object types of the members:

     #include "ctnnet.ch"

     aIn=NNETRDSET('MIKE',OBJ_USER,'SECURITY_EQUALS')
     FOR i=1 TO LEN(aIn)
     ?  NNETOBJNAM(aIn[i])
     ?? IF(NNETOBJTYP(aIn[i])=OBJ_USER,'User','Group')
     NEXT i

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