Platform SDK: Active Directory, ADSI, and Directory Services

DS_NAME_RESULT_ITEM

The DS_NAME_RESULT_ITEM structure contains a name converted by the DsCrackNames function, along with associated error and domain information.

typedef struct
{
  DWORD  status;
  LPTSTR pDomain;
  LPTSTR pName;
} DS_NAME_RESULT_ITEM, *PDS_NAME_RESULT_ITEM;

status

Indicates any errors encountered during conversion of this name. This member may have one of the following values.

Value	Meaning
DS_NAME_ERROR_DOMAIN_ONLY	Unable to resolve the entire name, but able to determine in which domain the object resides. The pDomain member will be valid when this error is returned.
DS_NAME_ERROR_NO_MAPPING	Input name was found, but not the associated output format. This error can happen if the object does not have all of the required attributes.
DS_NAME_ERROR_NO_SYNTACTICAL_MAPPING	Unable to perform a purely syntactical conversion at the client without going out over the network.
DS_NAME_ERROR_NOT_FOUND	Could not find the name at all, or the caller does not have the permissions to see it.
DS_NAME_ERROR_NOT_UNIQUE	Input name mapped to more than one output name.
DS_NAME_ERROR_RESOLVING	Generic processing error.
DS_NAME_NO_ERROR	No error.

pDomain

Pointer to a null-terminated Unicode string specifying the DNS domain in which the object resides.

pName

Pointer to a null-terminated Unicode string specifying the newly formatted object name.

The DsCrackNames function returns an array of DS_NAME_RESULT_ITEM structures as part of a DS_NAME_RESULT structure.

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntdsapi.h.
  Unicode: Declared as Unicode and ANSI structures.