Fonction CertRDNValueToStrW (wincrypt.h)

Article
11/20/2024

La fonction CertRDNValueToStr convertit un nom dans un CERT_RDN_VALUE_BLOB en chaîne de caractères null-terminated .

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 le 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 la fin caractère NULL.

Valeur de retour

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

Remarques

Si psz n’est pas NULL et que csz n’est pas zéro, le retourné est toujours une chaîne null éventuellement vide-terminated string.

Note

L’en-tête wincrypt.h définit CertRDNValueToStr comme 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 XP [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	wincrypt.h
bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Voir aussi

CertNameToStr

fonctions de conversion de données

Partager via