[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
NNETDELSET()
Deletes a bindery object from a set property
------------------------------------------------------------------------------
Syntax
NNETDELSET(<cName>,[<nType>],<cProperty>,<cMember>,
[<cMemberType>],[<cServer>|<nConId>]) --> lSuccess
Netware: 2.2 and 3.11
Arguments
<cName> Designates the name of the bindery object that is
processed.
<nType> Designates a numeric value that indicates the type of
<cName>. 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.
<cProperty> Designates the name of a set property of <cName>.
<cMember> Designates the name of the bindery object that is deleted
from <cProperty> of the bindery object <cName>.
<cMemberType> Designates a numeric value that specifies the type of
<cMember>. The default value is OBJ_USER.
<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
NNETDELSET() returns .T. if the operation has been completed
successfully. If an error occurs, the Novell error code can be queried
with the NNETERROR() function.
Description
Important! NNETDELSET() is a low level bindery function and should
be used only with extensive knowledge of the bindery concept and the
Novell API.
NOVELL NET DELETE BINDERY OBJECT FROM SET
Internally, Novell Netware has defined two different property types:
item and set properties. NNETDELSET() allows you to delete information
from a set property. A set property contains a list of references to
other bindery objects. An example is the GROUP_MEMBERS property that
contains a list of users who are members of a user group.
The parameters <cName> and <cType> identify the object, and <cProperty>
is the name of the property. <cMember> and <cMemberType> define the
bindery object that is deleted from <cProperty>. With the parameters
<cServer> or <nConId>, the bindery of any attached server can be
accessed. The connection ID of a server can be determined with
NNETATTACH() or NNETLOGIN().
To delete information from a property, sufficient bindery and property
access rights are required. 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.
Note
. NNETDELSET() deletes only the reference to the bindery object
<cMember> from <cProperty>. The object itself is not affected or
deleted.
Examples
. Delete user MIKE from the MARKET group:
#include "ctnnet.ch"
IF NNETDELSET('MARKET',OBJ_GROUP,'GROUP_MEMBERS','MIKE')
? 'User has been deleted from group!'
ELSE
? 'User could not be deleted!'
ENDIF
. To delete a user from a group, it is also necessary to delete
the group from two user properties. Use the function NNETREMGRP() to
remove a user from a group.
See Also:
NNETADDSET()
NNETREMGRP()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson