Fonction DsQuoteRdnValueA (dsparse.h)
La fonction DsQuoteRdnValue convertit un RDN en une valeur RDN entre guillemets, si la valeur RDN contient des caractères qui nécessitent des guillemets. Le RDN entre guillemets peut ensuite être envoyé dans le cadre d’un nom unique (DN) au service d’annuaire à l’aide de différentes API telles que LDAP. Un exemple d’un RDN qui nécessiterait des guillemets serait celui qui a une valeur séparée par des virgules, comme un RDN pour un nom qui utilise le format « last,first ».
Syntaxe
DSPARSE DWORD DsQuoteRdnValueA(
[in] DWORD cUnquotedRdnValueLength,
[in] LPCCH psUnquotedRdnValue,
[in, out] DWORD *pcQuotedRdnValueLength,
[out] LPCH psQuotedRdnValue
);
Paramètres
[in] cUnquotedRdnValueLength
Nombre de caractères dans la chaîne psUnquotedRdnValue .
[in] psUnquotedRdnValue
Chaîne qui spécifie la valeur RDN non guillemets.
[in, out] pcQuotedRdnValueLength
Nombre maximal de caractères dans la chaîne psQuotedRdnValue .
Les indicateurs suivants sont la sortie de ce paramètre.
ERROR_SUCCESS
Indique que le nombre correct de caractères a été trouvé dans psQuotedRdnValue.
ERROR_BUFFER_OVERFLOW
Indique que le nombre de caractères dans la chaîne ne correspond pas à psQuotedRdnValue.
[out] psQuotedRdnValue
Chaîne qui reçoit la valeur RDN convertie et peut-être entre guillemets.
Valeur retournée
La liste suivante contient les valeurs possibles retournées pour la fonction DsQuoteRdnValue .
Notes
Les guillemets ne sont pas ajoutés au RDN si aucun n’est requis. Dans ce cas, la valeur RDN de sortie est identique à la valeur RDN d’entrée.
Lorsque la citation est requise, le RDN est cité conformément à la spécification « Lightweight Directory Access Protocol (v3) : UTF-8 String Representation of Distinguished Names », RFC 2253.
Les valeurs RDN d’entrée et de sortie ne sont pas des chaînes terminées par NULL.
Pour rétablir les modifications apportées par cet appel, appelez la fonction DsUnquoteRdnValue .
Notes
L’en-tête dsparse.h définit DsQuoteRdnValue comme un 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.
Spécifications
| 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
Fonctions de gestion du contrôleur de domaine et de la réplication