DsIsMangledRdnValueA function (dsparse.h)

The DsIsMangledRdnValue function determines if a given relative distinguished name value is a mangled name of the given type.

Syntax

DSPARSE BOOL DsIsMangledRdnValueA(
  [in] LPCSTR        pszRdn,
  [in] DWORD         cRdn,
  [in] DS_MANGLE_FOR eDsMangleForDesired
);

Parameters

[in] pszRdn

Pointer to a null-terminated string that contains the relative distinguished name to determine if it is mangled. The cRdn parameter contains the number of characters in this string.

[in] cRdn

Contains the number of characters in the pszRdn string.

[in] eDsMangleForDesired

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

Return value

Returns TRUE if the relative distinguished name is mangled and the mangle type is the same as specified. Returns FALSE if the relative distinguished name is not mangled or the mangle type is different than specified.

Remarks

This function determines if the given relative distinguished name value is mangled and mangled in the given type. The pszRdn parameter should only contain the value of the relative distinguished name and not the key. The relative distinguished name value may be quoted or unquoted.

Note

The dsparse.h header defines DsIsMangledRdnValue 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

DsIsMangledDn