Changes the login name of the current user. Can also change the password of the current user if a value is specified. Neither argument is optional.
This method can be used to support MultiSite operations, and can be used to resolve ambiguous names.
To detect whether there are multiple users with the same name on other sites, you can use the GetDisplayNamesNeedingSiteExtension method in Session. For example, a user named "Tom" might have been created on more than one site.
There is no return value. Changes take effect at the next login.
VBScript
user.SetLoginName new_name, new_password
Perl
user->SetLoginName(new_name, new_password);
Perl
# change a user login name and password using SetLoginName
use CQPerlExt;
my $adminSession = CQAdminSession::Build();
($newusername, $newpasswd, $cqdb) = @ARGV;
$adminUser = "admin";
$adminPasswd = "";
$adminSession->Logon($adminUser, $adminPasswd, "");
$userobj = $adminSession->GetUser($user);
$userobj->SetLoginName($newusername, $newpasswd);
$dbobj= $adminSession->GetDatabase($cqdb);
$dbobj->UpgradeMasterUserInfo();
CQAdminSession::Unbuild($adminSession);