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