Click above to get retro games delivered to your door ever month!

 ObjNmeChg()
------------------------------------------------------------------------------
 Purpose:
 Change the name of an object.

 Syntax:
 bResult = ObjNmeChg( 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).

 Description:
 ObjNmeChg() 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 ( ObjNmeChg( "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.