INFO: Use Migration DLLs to obtain corrected user names (200323)

MORE INFORMATION

A user account on Windows 2000 can contain up to 20 uppercase or lowercase characters except for the following: If a Windows 95/98 user name contains any of these characters, Windows 2000 must change the user name to make it compatible with these rules. For the most updated information on user name conventions, see the Windows 2000 Help file on the Start Menu.

In a Migration DLL, the UserName argument of MigrateUserNT supplies three names, each separated by a null-terminating character. The names are in the following order:

• UserName - The Windows 95/98 name of the user.
• DomainName - The user's domain. This will be an empty string for local accounts.
• FixedUserName - The Windows 2000 name of the user. This name will only be different from UserName when it is necessary to make it compatible with Windows 2000.

The following code illustrates how to get each name, given the UserName parameter passed to the Migration DLL's MigrateUserNT function.

// UserName is NULL for the Default user
if (UserName)
{
   PCWSTR DomainName;
   PCWSTR FixedUserName;

   DomainName = wcschr (UserName, 0) + 1;
   FixedUserName = wcschr (DomainName, 0) + 1;

   // Use Names Here
}