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 |