DsCrackUnquotedMangledRdnW function (dsparse.h)

The DsCrackUnquotedMangledRdn function unmangles (unencodes) a given relative distinguished name and returns both the decoded GUID and the mangling type used.

DSPARSE BOOL DsCrackUnquotedMangledRdnW(
  [in]            LPCWSTR       pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

[in] pszRDN

Pointer to a string that contains the relative distinguished name (RDN) to translate. This string length is specified by the cchRDN parameter, so this string is not required to be null-terminated. This string must be in unquoted form. For more information about unquoted relative distinguished names, see DsUnquoteRdnValue.

[in] cchRDN

Contains the length, in characters, of the pszRDN string.

[out, optional] pGuid

Pointer to GUID value that receives the GUID of the unmangled relative distinguished name. This parameter can be NULL.

[out, optional] peDsMangleFor

Pointer to a DS_MANGLE_FOR value that receives the type of mangling used in the mangled relative distinguished name. This parameter can be NULL.

This function returns TRUE if the relative distinguished name is mangled or FALSE otherwise. If this function returns FALSE, neither pGuid or peDsMangleFor receive any data.

This function attempts to decode (unmangle) an RDN that has been previously mangled due to a deletion or a naming conflict. If the relative distinguished name is mangled, the function returns TRUE and retrieves the GUID and mangle type, if requested. If the relative distinguished name is not mangled, the function returns FALSE.

DS_MANGLE_FOR

Domain Controller and Replication Management Functions

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue