Directory Services

DsIsMangledRdnValue

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

BOOL DsIsMangledRdnValue(
  LPCTSTR pszRdn,
  DWORD cRdn,
  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 Values

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

Client: Included in Windows XP.
Server: Included in Windows Server 2003.
Unicode: Implemented as Unicode and ANSI versionson Windows NT/2000/XP.
Header: Declared in Ntdsapi.h.
Library: Use Ntdsapi.lib.

See Also

DS_MANGLE_FOR, DsIsMangledDn, Domain Controller and Replication Management Functions