DsIsMangledRdnValue function

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

Syntax

BOOL DsIsMangledRdnValue(
  _In_  LPCTSTR pszRdn,
  _In_  DWORD cRdn,
  _In_  DS_MANGLE_FOR eDsMangleForDesired
);

Parameters

pszRdn [in]

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.

cRdn [in]

Contains the number of characters in the pszRdn string.

eDsMangleForDesired [in]

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.

A change was made in the default quoting behavior of distinguished names returned from the other directory service functions between Windows 2000 and Windows XP. This routine transparently handles relative distinguished names with special character from either form.

Requirements

See also

DS_MANGLE_FOR

DsIsMangledDn

Domain Controller and Replication Management Functions

Send comments about this topic to Microsoft

Build date: 10/26/2012