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