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