Edit

User Name Formats

  • Article

When an application uses the Credentials Management API to prompt for credentials, the user is expected to enter information that can be validated, either by the operating system or by the application. The user can specify domain credentials information in one of the following formats:

User Principal Name

User principal name (UPN) format is used to specify an Internet-style name, such as UserName@Example.Microsoft.com. The following table summarizes the parts of a UPN.

Part Example
User account name. Also known as the logon name.
 UserName
Separator. A character literal, the at sign (@).
 @
UPN suffix. Also known as the domain name.
 Example.Microsoft.com

 

A UPN can be implicitly or explicitly defined. An implicit UPN is of the form UserName@DNSDomainName.com. An implicit UPN is always associated with the user's account, even if an explicit UPN is not defined. An explicit UPN is of the form Name@Suffix, where both the name and suffix strings are explicitly defined by the administrator.

Down-Level Logon Name

The down-level logon name format is used to specify a domain and a user account in that domain, for example, DOMAIN\UserName. The following table summarizes the parts of a down-level logon name.

Part Example
NetBIOS domain name.
 DOMAIN
Separator. A character literal, the backslash (\).
 \
User account name. Also known as the logon name.
 UserName