DsIsMangledRdnValueW function (dsparse.h)

Article
02/22/2024

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

Syntax

DSPARSE BOOL DsIsMangledRdnValueW(
  [in] LPCWSTR       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 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
Target Platform	Windows
Header	dsparse.h (include Ntdsapi.h)
Library	Ntdsapi.lib
DLL	Ntdsapi.dll