DsIsMangledDnA function (dsparse.h)

The DsIsMangledDn function determines if the first relative distinguished name (RDN) in a distinguished name (DN) is a mangled name of a given type.

Syntax

DSPARSE BOOL DsIsMangledDnA(
  [in] LPCSTR        pszDn,
  [in] DS_MANGLE_FOR eDsMangleFor
);

Parameters

[in] pszDn

Pointer to a null-terminated string that contains the distinguished name to retrieve the relative distinguished name from. This can also be a quoted distinguished name as returned by other directory service functions.

[in] eDsMangleFor

Contains one of the DS_MANGLE_FOR values that specifies the type of name mangling to look for.

Return value

Returns TRUE if the first relative distinguished name in pszDn is mangled in the manner specified by eDsMangleFor or FALSE otherwise.

Remarks

Note

The dsparse.h header defines DsIsMangledDn as an alias that 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 is 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
Target Platform Windows
Header dsparse.h (include Ntdsapi.h)
Library Ntdsapi.lib
DLL Ntdsapi.dll

See also

DS_MANGLE_FOR

Domain Controller and Replication Management Functions

DsIsMangledRdnValue