[<<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