GetFriendlyNameOfCertA, fonction (cryptdlg.h)

  • Article

[La fonction GetFriendlyNameOfCert est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt la fonction CertGetNameString avec l’indicateur CERT_NAME_FRIENDLY_DISPLAY_TYPE.]

La fonction GetFriendlyNameOfCert récupère le nom d’affichage d’un certificat.

Note Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers CryptDlg.dll.
 

Syntaxe

CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
  [in]  PCCERT_CONTEXT pccert,
  [out] LPSTR          pch,
  [in]  DWORD          cch
);

Paramètres

[in] pccert

Pointeur vers le contexte de certificat dont le nom d’affichage est en cours de récupération.

[out] pch

Pointeur vers une chaîne de caractères qui reçoit le nom d’affichage du certificat.

[in] cch

Nombre de caractères alloués pour pchBuffer, y compris le caractère NULL de fin.

Valeur retournée

La valeur de retour est le nombre de caractères, y compris le caractère NULL de fin, dans le nom d’affichage retourné.

Remarques

Notes

L’en-tête cryptdlg.h définit GetFriendlyNameOfCert 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

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête cryptdlg.h
DLL CryptDlg.dll