GetFriendlyNameOfCertA, fonction (cryptdlg.h)

Article
11/20/2024

[La fonction GetFriendlyNameOfCert est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il 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 complet d’un certificat.

Remarque Cette fonction n’a aucune 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 récupéré.

[out] pch

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

[in] cch

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

Valeur de retour

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

Remarques

Note

L’en-tête cryptdlg.h définit GetFriendlyNameOfCert 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 uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	cryptdlg.h
DLL	CryptDlg.dll

Partager via