DsUnquoteRdnValueW, fonction (dsparse.h)

Article
11/20/2024

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.

Syntaxe

DSPARSE DWORD DsUnquoteRdnValueW(
  [in]      DWORD  cQuotedRdnValueLength,
  [in]      LPCWCH psQuotedRdnValue,
  [in, out] DWORD  *pcUnquotedRdnValueLength,
  [out]     LPWCH  psUnquotedRdnValue
);

Paramètres

[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.

ERROR_SUCCESS

Cette propriété est retournée si le nombre de caractères correspond à la chaîne utilisée dans psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

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.

Valeur de retour

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

Remarques

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é.

Les actions suivantes sont effectuées lorsque psQuotedRdnValue n’est pas cité :

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 actions suivantes sont toujours effectuées :

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.

Note

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.

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

DsQuoteRdnValue

Partager via