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

 GrpNameChange()
------------------------------------------------------------------------------
 Purpose:
 Change a group name.

 Syntax:
 bResult = GrpNameChange( lpszOldName, lpszNewName )

 Parameters:
 lpszOldName The old name of the group.
 lpszNewName The new name of the group.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 GrpNmeChg()

 Description:
 GrpNameChange() renames an existing user group from its old name,
 specified by lpszOldName to a new name specified by lpszNewName.

 Returns TRUE if successful or FALSE if an error occurs.

 Example:
 // To rename user group ACCOUNTS to PAYROLL:
 if ( GrpNameChange( "ACCOUNTS", "PAYROLL" ) )
    ? "User group ACCOUNTS is now called PAYROLL"
 endif

 Notes:
 This function retains all membership information, and simply
 renames the title given to the group.

 This function may require Supervisor equivalence, depending on the security
 level of the group.