DS_NAME_RESULT_ITEMA structure (ntdsapi.h)

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

Syntax

typedef struct {
  DWORD status;
#if ...
  CHAR  *pDomain;
#if ...
  CHAR  *pName;
#else
  LPSTR pDomain;
#endif
#else
  LPSTR pName;
#endif
} DS_NAME_RESULT_ITEMA, *PDS_NAME_RESULT_ITEMA;

Members

status

Contains one of the DS_NAME_ERROR values that indicates the status of this name conversion.

pDomain

Pointer to a null-terminated string that specifies the DNS domain in which the object resides. This member will contain valid data if status contains DS_NAME_NO_ERROR or DS_NAME_ERROR_DOMAIN_ONLY.

pName

Pointer to a null-terminated string that specifies the newly formatted object name.

Remarks

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

Note

The ntdsapi.h header defines DS_NAME_RESULT_ITEM as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

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

See also

DS_NAME_RESULT

Domain Controller and Replication Management Structures

DsCrackNames