DsCrackUnquotedMangledRdnA, fonction (dsparse.h)

  • Article

La fonction DsCrackUnquotedMangledRdn désmangle (déscode) un nom unique relatif donné et retourne à la fois le GUID décodé et le type de mangling utilisé.

Syntaxe

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        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 étant spécifiée par le paramètre cchRDN , cette chaîne n’a pas besoin d’être terminée par null. Cette chaîne doit être sous forme non mise en guillemets. 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 la valeur GUID 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 retournée

Cette fonction retourne TRUE si le nom unique relatif est mangle ou FALSE dans le cas contraire. Si cette fonction retourne FALSE, ni pGuid ni peDsMangleFor ne reçoivent de données.

Remarques

Cette fonction tente de décoder (démangler) 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 mangle, la fonction retourne TRUE et récupère le GUID et le type de mangle, si demandé. Si le nom unique relatif n’est pas désactivé, la fonction retourne FALSE.

Notes

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. La combinaison 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête dsparse.h (inclure Ntdsapi.h)
Bibliothèque Ntdsapi.lib
DLL Ntdsapi.dll

Voir aussi

DS_MANGLE_FOR

Fonctions de gestion des contrôleurs de domaine et de la réplication

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue