DsCrackUnquotedMangledRdnA, fonction (dsparse.h)

Article
02/26/2024

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

Partager via