Partager via


DsCrackUnquotedMangledRdnW, fonction (dsparse.h)

L'DsCrackUnquotedMangledRdn function unmangles (unncodes) un nom unique relatif donné et retourne à la fois le GUID décodé et le type de mangling utilisé.

Syntaxe

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

Paramètres

[in] pszRDN

Pointeur vers une chaîne qui contient le nom unique relatif (RDN) à traduire. Cette longueur de chaîne est spécifiée par le paramètre cchRDN . Cette chaîne n’est donc pas nécessaire pour être terminée par null. Cette chaîne doit être sous forme nonquoée. Pour plus d’informations sur les noms uniques relatifs non cités, consultez DsUnquoteRdnValue.

[in] cchRDN

Contient la longueur, en caractères, de la chaîne pszRDN.

[out, optional] pGuid

Pointeur vers GUID valeur qui reçoit le GUID du nom unique relatif non managé. Ce paramètre peut être NULL.

[out, optional] peDsMangleFor

Pointeur vers une valeur DS_MANGLE_FOR qui reçoit le type de mangling utilisé dans le nom unique relatif mangled. Ce paramètre peut être NULL.

Valeur de retour

Cette fonction retourne TRUE si le nom unique relatif est mangle ou FALSE sinon. Si cette fonction retourne FALSE, aucune pGuid ou peDsMangleFor reçoivent des données.

Remarques

Cette fonction tente de décoder (dissocier) un RDN qui a été précédemment mangle en raison d’une suppression ou d’un conflit d’affectation de noms. Si le nom unique relatif est désactivé, la fonction retourne TRUE et récupère le GUID et le type de bascule, s’il est demandé. Si le nom unique relatif n’est pas mangled, la fonction retourne FALSE.

Note

L’en-tête dsparse.h définit DsCrackUnquotedMangledRdn comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista
serveur minimum pris en charge Windows Server 2008
plateforme cible Windows
d’en-tête dsparse.h (include Ntdsapi.h)
bibliothèque Ntdsapi.lib
DLL Ntdsapi.dll

Voir aussi

DS_MANGLE_FOR

fonctions de gestion du contrôleur de domaine et de la réplication

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue