[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETNUMMEM()
 Determines the number of members of a set property
------------------------------------------------------------------------------
 Syntax

     NNETNUMMEM(<cObjName>,[<nType>],<cPropName>,
        [<cServer>|<nConId>]) --> nNumber

     Netware: 2.2 and 3.11

 Arguments

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

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

     <cPropName>  Designates the name of the property for which the
     members are counted.  <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 

     NNETNUMMEM() returns the number of members of the property <cPropName>
     of <cObjName>.  If an error occurs, the function returns -1.

 Description

     NOVELL NET COUNT MEMBERS
     Internally, Novell Netware defines two possible property types: item and
     set properties.  Unlike an item property that accepts any kind of data,
     the set property contains references to other bindery objects.  These
     bindery objects are the members of the set property.  This function
     allows you to determine the total of members of a set property without
     having to specify all the members explicitly.

     The object type <nType> must be passed in the high-low format (see the
     Introduction to this chapter).  For the object types, use the symbolic
     constants of the header file CTNNET.CH.  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

     Determine the number of members of the group EVERYONE:

     #include "ctnnet.ch"

     ? NNETNUMMEM('EVERYONE',OBJ_GROUP,'GROUP_MEMBERS')

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson