Edit

Share via

ADS_NAME_TYPE_ENUM enumeration (iads.h)

  • Article

The ADS_NAME_TYPE_ENUM enumeration specifies the formats used for representing distinguished names. It is used by the IADsNameTranslate interface to convert the format of a distinguished name.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0001_0050_0001 {
  ADS_NAME_TYPE_1779 = 1,
  ADS_NAME_TYPE_CANONICAL = 2,
  ADS_NAME_TYPE_NT4 = 3,
  ADS_NAME_TYPE_DISPLAY = 4,
  ADS_NAME_TYPE_DOMAIN_SIMPLE = 5,
  ADS_NAME_TYPE_ENTERPRISE_SIMPLE = 6,
  ADS_NAME_TYPE_GUID = 7,
  ADS_NAME_TYPE_UNKNOWN = 8,
  ADS_NAME_TYPE_USER_PRINCIPAL_NAME = 9,
  ADS_NAME_TYPE_CANONICAL_EX = 10,
  ADS_NAME_TYPE_SERVICE_PRINCIPAL_NAME = 11,
  ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME = 12
} ADS_NAME_TYPE_ENUM;

Constants

 
ADS_NAME_TYPE_1779
Value: 1
Name format as specified in RFC 1779. For example, "CN=Jeff Smith,CN=users,DC=Fabrikam,DC=com".
ADS_NAME_TYPE_CANONICAL
Value: 2
Canonical name format. For example, "Fabrikam.com/Users/Jeff Smith".
ADS_NAME_TYPE_NT4
Value: 3
Account name format used in Windows. For example, "Fabrikam\JeffSmith".
ADS_NAME_TYPE_DISPLAY
Value: 4
Display name format. For example, "Jeff Smith".
ADS_NAME_TYPE_DOMAIN_SIMPLE
Value: 5
Simple domain name format. For example, "JeffSmith@Fabrikam.com".
ADS_NAME_TYPE_ENTERPRISE_SIMPLE
Value: 6
Simple enterprise name format. For example, "JeffSmith@Fabrikam.com".
ADS_NAME_TYPE_GUID
Value: 7
Global Unique Identifier format. For example, "{95ee9fff-3436-11d1-b2b0-d15ae3ac8436}".
ADS_NAME_TYPE_UNKNOWN
Value: 8
Unknown name type. The system will estimate the format. This element is a meaningful option only with the IADsNameTranslate.Set or the IADsNameTranslate.SetEx method, but not with the IADsNameTranslate.Get or IADsNameTranslate.GetEx method.
ADS_NAME_TYPE_USER_PRINCIPAL_NAME
Value: 9
User principal name format. For example, "JeffSmith@Fabrikam.com".
ADS_NAME_TYPE_CANONICAL_EX
Value: 10
Extended canonical name format. For example, "Fabrikam.com/Users Jeff Smith".
ADS_NAME_TYPE_SERVICE_PRINCIPAL_NAME
Value: 11
Service principal name format. For example, "www/www.fabrikam.com@fabrikam.com".
ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME
Value: 12
A SID string, as defined in the Security Descriptor Definition Language (SDDL), for either the SID of the current object or one from the object SID history. For example, "O:AOG:DAD:(A;;RPWPCCDCLCSWRCWDWOGA;;;S-1-0-0)" For more information, see Security Descriptor String Format.

Remarks

Code examples written in C++, Visual Basic, and VBS/ASP can be found in the discussions of the IADsNameTranslate interface.

Because VBScript cannot read data from a type library, an application must use the appropriate numeric constants, instead of the symbolic constants, to set the appropriate flags. To use the symbolic constants as a good programming practice, write explicit declarations of such constants, as done here, in VBScript applications.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Header iads.h

See also

ADSI Enumerations

IADsNameTranslate

IADsNameTranslate.Get

IADsNameTranslate.GetEx

IADsNameTranslate.Set

IADsNameTranslate.SetEx

Security Descriptor String Format