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

     NNETRENOBJ(<cOldName>,[<nType>],<cNewName>,
        [<cServer>|<nConId>]) --> lSuccess

     Netware: 2.2 and 3.11

 Arguments

     <cOldName>  Designates the name of the bindery object that is
     renamed.

     <nType>  Designates a numeric value that specifies the type of
     <cOldName>.  The header file CTNNET.CH contains symbolic constants of
     the object type defined by Novell for use in conjunction with the
     bindery functions of CA-Clipper Tools.  The default value indicates the
     object type OBJ_USER.

     <cNewName>  Designates the new name for the bindery object.

     <cServer>  Designates the name of the file server of which the
     bindery is accessed.  Your workstation must be attached to <cServer>.

     <nConId>  Designates the connection ID of your workstation on
     <cServer>.

 Returns

     NNETRENOBJ() returns .T. if the bindery object has been renamed
     successfully.  If an error occurs, the error code can be queried with
     NNETERROR().

 Description

     Important!  NNETRENOBJ() is a low level bindery function and should
     be used only with extensive knowledge of the bindery concept and the
     Novell API.

     NOVELL NET RENAME BINDERY OBJECT
     NNETRENOBJ() allows you to rename bindery objects.  For example, this
     function can be used to change the login name of a user.  With the
     parameters <cServer> or <nConId>, the bindery object of any attached
     server can be accessed.  The connection ID of a server is returned by
     NNETATTACH() or NNETLOGIN().

     To rename an object, the requesting user must have supervisor rights on
     the related file server.  NNETRENOBJ() expects the object type in the
     high-low sequence for efficiency reasons.

 Note

     .  NNETRENOBJ() must be used to rename users or user groups, as
        no other high level function is available in CA-Clipper Tools.

 Examples

     .  Rename user JIM to JAMES and evaluate the return values:

        IF NNETRENOBJ('JIM',,'JAMES')
        ? 'User has been renamed successfully!'
        ELSE
        ? 'Failure during rename!'
        ENDIF

     .  Rename the group DEV to TECH:

        #include "ctnnet.ch"

        NNETRENOBJ('DEV',OBJ_GROUP,'TECH')

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