Fonction DsQuoteRdnValueA (dsparse.h)

  • Article

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

DsUnquoteRdnValue