DsUnquoteRdnValueA, fonction (dsparse.h)
La fonction DsUnquoteRdnValue est un appel client qui convertit une valeur RDN entre guillemets en valeur RDN non mise en guillemet. Étant donné que le RDN a été initialement placé entre guillemets, car il contenait des caractères qui pouvaient être mal interprétés lorsqu’il était incorporé dans un nom unique (DN), la valeur RDN non mise en guillemet ne doit pas être envoyée dans le cadre d’un DN au service d’annuaire à l’aide de diverses API telles que LDAP.
DSPARSE DWORD DsUnquoteRdnValueA(
[in] DWORD cQuotedRdnValueLength,
[in] LPCCH psQuotedRdnValue,
[in, out] DWORD *pcUnquotedRdnValueLength,
[out] LPCH psUnquotedRdnValue
);
[in] cQuotedRdnValueLength
Nombre de caractères dans la chaîne psQuotedRdnValue.
[in] psQuotedRdnValue
Valeur RDN qui peut être entre guillemets et échappées.
[in, out] pcUnquotedRdnValueLength
La valeur d’entrée de cet argument est la longueur maximale, en caractères, de psQuotedRdnValue.
La valeur de sortie de cet argument inclut les indicateurs suivants.
Cette propriété est retournée si le nombre de caractères correspond à la chaîne utilisée dans psQuotedRdnValue.
Cette propriété est retournée si le nombre de caractères ne correspond pas à la chaîne utilisée dans psQuotedRdnValue.
[out] psUnquotedRdnValue
Valeur RDN convertie et non mise en guillemets.
La liste suivante contient les valeurs possibles retournées pour la fonction DsUnquoteRdnValue.
Lorsque psQuotedRdnValue est cité :
- Les guillemets de début et de fin sont supprimés.
- Espace blanc avant l’abandon de la première citation.
- L’espace blanc à la fin de la dernière citation est ignoré.
- Les échappements sont supprimés et le caractère suivant l’échappement est conservé.
- L’espace blanc de début est ignoré.
- L’espace blanc de fin est conservé.
- Les caractères non spéciaux échappés retournent une erreur.
- Les caractères spéciaux non émis retournent une erreur.
- Les valeurs RDN commençant par # (ignorant l’espace blanc de début) sont gérées en tant que valeur BER qui a été convertie précédemment en chaîne et converties en conséquence.
- Les chiffres hexadécimaux échappés (\89) sont convertis en octets binaires (0x89).
- Les échappements sont supprimés des caractères spéciaux échappés.
- Les caractères spéciaux échappés ne sont pas échapés.
- Les valeurs RDN d’entrée et de sortie ne sont pas des valeurs terminées par null.
Notes
L’en-tête dsparse.h définit DsUnquoteRdnValue 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.
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 |
fonctions de gestion du contrôleur de domaine et de la réplication