Fonction CertRDNValueToStrA (wincrypt.h)

  • Article

La fonction CertRDNValueToStr convertit un nom dans un CERT_RDN_VALUE_BLOBen chaîne de caractères terminée par null.

Syntaxe

DWORD CertRDNValueToStrA(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPSTR                psz,
  [in]  DWORD                csz
);

Paramètres

[in] dwValueType

Indique le type de valeur RDN à convertir.

Il peut s’agir de l’une des valeurs suivantes :

  • CERT_RDN_ANY_TYPE
  • CERT_RDN_ENCODED_BLOB
  • CERT_RDN_OCTET_STRING
  • CERT_RDN_NUMERIC_STRING
  • CERT_RDN_PRINTABLE_STRING
  • CERT_RDN_TELETEX_STRING
  • CERT_RDN_T61_STRING
  • CERT_RDN_VIDEOTEX_STRING
  • CERT_RDN_IA5_STRING
  • CERT_RDN_GRAPHIC_STRING
  • CERT_RDN_VISIBLE_STRING
  • CERT_RDN_ISO646_STRING
  • CERT_RDN_GENERAL_STRING
  • CERT_RDN_UNIVERSAL_STRING
  • CERT_RDN_INT4_STRING
  • CERT_RDN_BMP_STRING
  • CERT_RDN_UNICODE_STRING
  • CERT_RDN_UTF8_STRING

[in] pValue

Pointeur vers un CERT_RDN_VALUE_BLOB d’un type approprié pour dwValueType.

[out] psz

Pointeur vers une mémoire tampon pour recevoir la chaîne retournée.

[in] csz

Taille, en caractères, allouée pour la chaîne retournée. La taille doit inclure le caractère NULL de fin.

Valeur retournée

Retourne le nombre de caractères convertis, y compris le caractère NULL de fin. Si psz a la valeur NULL ou que csz a la valeur zéro, retourne la taille requise de la chaîne de destination.

Remarques

Si psz n’a pas la valeur NULL et que csz n’est pas zéro, le psz retourné est toujours une chaîne vide terminée par une valeur Null.

Notes

L’en-tête wincrypt.h définit CertRDNValueToStr 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. La combinaison 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CertNameToStr

Fonctions de conversion de données