Directory Services

DS_NAME_FLAGS

The DS_NAME_FLAGS enumeration is used to define how the name syntax will be cracked. These flags are used by the DsCrackNames function.

typedef enum 
{
  DS_NAME_NO_FLAGS = 0x0, 
  DS_NAME_FLAG_SYNTACTICAL_ONLY = 0x1, 
  DS_NAME_FLAG_EVAL_AT_DC = 0x2, 
  DS_NAME_FLAG_GCVERIFY = 0x4, 
  DS_NAME_FLAG_TRUST_REFERRAL = 0x8
} DS_NAME_FLAGS;

Values

DS_NAME_NO_FLAGS
Indicates that there are no associated flags.
DS_NAME_FLAG_SYNTACTICAL_ONLY
Performs a syntactical mapping at the client without transferring over the network. The only syntactic mapping supported is from DS_FQDN_1779_NAME to DS_CANONICAL_NAME or DS_CANONICAL_NAME_EX. DsCrackNames returns the DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING flag if a syntactical mapping is not possible.
DS_NAME_FLAG_EVAL_AT_DC
Forces a trip to the domain controller for evaluation, even if the syntax could be cracked locally.
DS_NAME_FLAG_GCVERIFY
The call fails if the domain controller is not a global catalog server.
DS_NAME_FLAG_TRUST_REFERRAL
Enables cross forest trust referral.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Ntdsapi.h.

See Also

DsCrackNames, DS_NAME_FORMAT, Active Directory Enumerations