[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 NNETDELOBJ()
 Deletes a bindery object
------------------------------------------------------------------------------
 Syntax

     NNETDELOBJ(<cName>,[<nType>],[<cServer>|<nConId>])
         --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cName> Designates the name of the bindery object that is deleted.

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

     <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

     NNETDELTOBJ() returns .T. if the object <cName> has been deleted
     successfully.  If an error occurs, the Novell error code can be queried
     with the NNETERROR() function.

 Description

     Important!  NNETDELOBJ() 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
     NNETDELOBJ() allows you to delete bindery objects.  Users and user
     groups can be deleted.  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().

     Supervisor rights are required to delete a bindery object.  For
     efficiency reasons, user defined object types must be passed in the high-
     low format.

 Note

     .  CA-Clipper Tools has no high level function available to
        delete users or user groups.  Use NNETDELOBJ().

 Examples

     .  Delete user GUEST:

        IF NNETDELOBJ('GUEST')
        ? 'User has been deleted successfully!'
        ELSE
        ? 'User could not be deleted!'
        ENDIF

     .  Delete group DEV:

        #include "ctnnet.ch"

        IF NNETDELOBJ('DEV',OBJ_GROUP)
        ? 'Group has been deleted successfully!'
        ELSE
        ? 'Group could not be deleted!'
        ENDIF

See Also: NNETCRTOBJ() NNETDELPRP() NNETERROR()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson