DS_NAME_ERROR

The DS_NAME_ERROR enumeration defines the errors returned by the status member of the DS_NAME_RESULT_ITEM structure. These are potential errors that may be encountered while a name is converted by the DsCrackNames function.

typedef enum 
{
  DS_NAME_NO_ERROR = 0, 
  DS_NAME_ERROR_RESOLVING = 1, 
  DS_NAME_ERROR_NOT_FOUND = 2, 
  DS_NAME_ERROR_NOT_UNIQUE = 3, 
  DS_NAME_ERROR_NO_MAPPING = 4, 
  DS_NAME_ERROR_DOMAIN_ONLY = 5, 
  DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING = 6, 
  DS_NAME_ERROR_TRUST_REFERRAL = 7
} DS_NAME_ERROR;

Values

DS_NAME_NO_ERROR

The conversion was successful.

DS_NAME_ERROR_RESOLVING

A generic processing error ocurred.

DS_NAME_ERROR_NOT_FOUND

The name cannot be found or the caller does not have permission to access the name.

DS_NAME_ERROR_NOT_UNIQUE

The input name is mapped to more than one output name or the desired format did not have a single, unique value for the object found.

DS_NAME_ERROR_NO_MAPPING

The input name was found, but the associated output format cannot be found. This can occur if the object does not have all the required attributes.

DS_NAME_ERROR_DOMAIN_ONLY

Unable to resolve entire name, but was able to determine in which domain object resides. The caller is expected to retry the call at a domain controller for the specified domain. The entire name cannot be resolved, but the domain that the object resides in could be determined. The pDomain member of the DS_NAME_RESULT_ITEM contains valid data when this error is specified.

DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING

A syntactical mapping cannot be performed on the client without transmitting over the network.

DS_NAME_ERROR_TRUST_REFERRAL

The name is from an external trusted forest.

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_RESULT_ITEM, Active Directory Enumerations