
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> objnamechange()</b>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
ObjNameChange()
------------------------------------------------------------------------------
Purpose:
Change the name of an object.
Syntax:
bResult = ObjNameChange( lpszOldName, lpszNewName, wObjectType )
Parameters:
lpszOldName The existing name of the object.
lpszNewName The new name of the object.
wObjectType The object type.
Returns:
A boolean value (TRUE or FALSE).
The CA-Clipper name for this function is:
ObjNmeChg()
Description:
ObjNameChange() renames an existing object of specified name lpszOldName
to the new name lpszNewName, where wObjectType is the object type.
Returns TRUE if successful, or FALSE if an error occurs.
Example:
// To rename user name JOHN to JACK:
if ( ObjNameChange( "JOHN", "JACK", OT_USER ) )
? "User object JOHN has now had his name changed to JACK"
endif
Notes:
This function requires Supervisor equivalence.
For more information on valid object types, see the reference in Bindery
Functions, Chapter 3.
See Also: FSObjectAdd() FSObjectDelete() FSObjectList() ObjIDGet() ObjTypeGet() ObjNameGet()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson