DsQuoteRdnValueW, fonction (dsparse.h)

Article
11/20/2024

La fonction DsQuoteRdnValue convertit un RDN en 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 diverses API telles que LDAP. Un exemple de RDN qui nécessiterait des guillemets serait une valeur séparée par des virgules, telle qu’un RDN pour un nom qui utilise le format « last,first ».

Syntaxe

DSPARSE DWORD DsQuoteRdnValueW(
  [in]      DWORD  cUnquotedRdnValueLength,
  [in]      LPCWCH psUnquotedRdnValue,
  [in, out] DWORD  *pcQuotedRdnValueLength,
  [out]     LPWCH  psQuotedRdnValue
);

Paramètres

[in] cUnquotedRdnValueLength

Nombre de caractères dans la chaîne psUnquotedRdnValue.

[in] psUnquotedRdnValue

Chaîne qui spécifie la valeur RDN nonquotée.

[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 de la chaîne ne correspond pas psQuotedRdnValue.

[out] psQuotedRdnValue

Chaîne qui reçoit la valeur RDN convertie, et peut-être entre guillemets.

Valeur de retour

La liste suivante contient les valeurs possibles retournées pour la fonction DsQuoteRdnValue.

Remarques

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 le guillemet est requis, le RDN est cité conformément à la spécification « Lightweight Directory Access Protocol (v3) : Représentation sous forme de chaîne UTF-8 des noms uniques », RFC 2253.

Les valeurs RDN d’entrée et de sortie ne sont pas chaînes null-terminated.

Pour rétablir les modifications apportées par cet appel, appelez la fonction DsUnquoteRdnValue.

Note

L’en-tête dsparse.h définit DsQuoteRdnValue en tant qu’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

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

DsUnquoteRdnValue

Partager via