DS_NAME_ERROR enumeration (ntdsapi.h)

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.

Syntax

typedef enum  {
  DS_NAME_NO_ERROR,
  DS_NAME_ERROR_RESOLVING,
  DS_NAME_ERROR_NOT_FOUND,
  DS_NAME_ERROR_NOT_UNIQUE,
  DS_NAME_ERROR_NO_MAPPING,
  DS_NAME_ERROR_DOMAIN_ONLY,
  DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING,
  DS_NAME_ERROR_TRUST_REFERRAL
} DS_NAME_ERROR;

Constants

Name Description
DS_NAME_NO_ERROR The conversion was successful.
DS_NAME_ERROR_RESOLVING A generic processing error occurred.
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

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Header ntdsapi.h

See also

DS_NAME_RESULT_ITEM

DsCrackNames

Enumerations in Active Directory Domain Services