Fonction CertRDNValueToStrW (wincrypt.h)
La fonction CertRDNValueToStr convertit un nom dans un CERT_RDN_VALUE_BLOB en chaîne de caractères null.
Syntaxe
DWORD CertRDNValueToStrW(
[in] DWORD dwValueType,
[in] PCERT_RDN_VALUE_BLOB pValue,
[out] LPWSTR 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 null éventuellement vide.
Notes
L’en-tête wincrypt.h définit CertRDNValueToStr comme un 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.
Configuration requise
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 |