[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
NNETADDSET()
Adds a bindery object to a set property
------------------------------------------------------------------------------
Syntax
NNETADDSET(<cObjName>,[<nType>],<cPropName>,<cMember>,
[<cMemberType>],[<cServer>|<nConId>]) --> lSuccess
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
<cObjName>. 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.
<cPropName> Designates the name of the set property of <cObjName>.
<cMember> Designates the name of the bindery object that is stored
in the property <cPropName> of the bindery object <cObjName>.
<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 that contains the
bindery that is accessed. Your workstation must be attached to
<cServer>.
<nConId> Designates the connection ID of your workstation on
<cServer>.
Returns
NNETADDSET() returns .T. if the bindery object has been added
successfully. If an error occurs, the Novell error code can be queried
with the NNETERROR() function.
Description
Important! NNETADDSET() is a low level bindery function and should
be used only with extensive knowledge of the bindery concept and the
Novell API.
NOVELL NET ADD BINDERY OBJECT TO SET
Internally, Novell Netware differentiates between two possible property
types: item and set property. The function NNETADDSET() allows the
storage of information to a set property. Set properties contain a list
of references to other bindery objects. For example, the GROUP_MEMBERS
property contains a list of users that are members of a user group.
The parameters <cObjName> and <nType> describe the object that is
processed. <cPropName> is the name of the property. The property must
have been created before (for example, with the NNETCRTPRP() function).
<cMember> and <cMemberType> specify the bindery object that is added to
<cPropName>. By passing the parameters <cServer> or <nConId>, it is
possible to access the bindery of any connected file server. The
connection ID of a server can be determined with the functions
NNETATTACH() or NNETLOGIN().
Prerequisites for a successful call of NNETADDSET() are sufficient
bindery and property access rights. The necessary property access
rights depend on the property security of the property that is
manipulated. For efficiency reasons, user defined object types must be
passed in the high-low format.
Examples
. Add user MIKE to the MARKET group :
#include "ctnnet.ch"
IF NNETADDSET('MARKET',OBJ_GROUP,'GROUP_MEMBERS','MIKE')
? 'User added successfully!'
ELSE
? 'No user added!'
ENDIF
. To add a user to a group, it is also necessary to add the
group to two user properties. Use NNETADDGRP() when adding a user to
a group.
See Also:
NNETADDGRP()
NNETCRTPRP()
NNETDELSET()
NNETWRTITM()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson