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