Edit

Share via

EXTENDED_NAME_FORMAT enumeration (secext.h)

  • Article

Specifies a format for a directory service object name.

Syntax

typedef enum {
  NameUnknown = 0,
  NameFullyQualifiedDN = 1,
  NameSamCompatible = 2,
  NameDisplay = 3,
  NameUniqueId = 6,
  NameCanonical = 7,
  NameUserPrincipal = 8,
  NameCanonicalEx = 9,
  NameServicePrincipal = 10,
  NameDnsDomain = 12,
  NameGivenName = 13,
  NameSurname = 14
} EXTENDED_NAME_FORMAT, *PEXTENDED_NAME_FORMAT;

Constants

 
NameUnknown
Value: 0
An unknown name type.
NameFullyQualifiedDN
Value: 1
The fully qualified distinguished name (for example, CN=Jeff Smith,OU=Users,DC=Engineering,DC=Microsoft,DC=Com).
NameSamCompatible
Value: 2
A legacy account name (for example, Engineering\JSmith). The domain-only version includes trailing backslashes (\).
NameDisplay
Value: 3
A "friendly" display name (for example, Jeff Smith). The display name is not necessarily the defining relative distinguished name (RDN).
NameUniqueId
Value: 6
A GUID string that the
IIDFromString function returns (for example, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).
NameCanonical
Value: 7
The complete canonical name (for example, engineering.microsoft.com/software/someone). The domain-only version includes a trailing forward slash (/).
NameUserPrincipal
Value: 8
The user principal name (for example, someone@example.com).
NameCanonicalEx
Value: 9
The same as NameCanonical except that the rightmost forward slash (/) is replaced with a new line character (\n), even in a domain-only case (for example, engineering.microsoft.com/software\nJSmith).
NameServicePrincipal
Value: 10
The generalized service principal name (for example, www/www.microsoft.com@microsoft.com).
NameDnsDomain
Value: 12
The DNS domain name followed by a backward-slash and the SAM user name.
NameGivenName
Value: 13
The first name or given name of the user. Note: This type is only available for GetUserNameEx calls for an Active Directory user.
NameSurname
Value: 14
The last name or surname of the user. Note: This type is only available for GetUserNameEx calls for an Active Directory user.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header secext.h (include Security.h)

See also

GetComputerObjectName

GetUserNameEx

TranslateName