Fonction CertRDNValueToStrA (wincrypt.h)
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 |