Partager via


CryptUIDlgSelectCertificate, fonction

La fonction CryptUIDlgSelectCertificate affiche une boîte de dialogue qui permet à un utilisateur de sélectionner un certificat.

Syntaxe

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Paramètres

pcsc [in]

Pointeur vers une structure de CRYPTUI_SELECTCERTIFICATE_STRUCT qui contient des informations sur la boîte de dialogue à afficher.

Valeur retournée

Pointeur vers une structure CERT_CONTEXT qui représente le certificat sélectionné par l’utilisateur. Une fois ce certificat terminé, vous devez passer ce pointeur à la fonction CertFreeCertificateContext pour décrémenter le nombre de références du contexte de certificat.

Si le membre dwFlags de la structure pcsc ne contient pas l’indicateur CRYPTUI_SELECTCERT_MULTISELECT , une valeur de retour NULL signifie que l’utilisateur a fermé la boîte de dialogue sans sélectionner de certificat.

Si le membre dwFlags de la structure pcsc contient l’indicateur CRYPTUI_SELECTCERT_MULTISELECT , cette fonction retourne toujours NULL. Les certificats sélectionnés seront contenus dans le magasin de certificats représenté par le membre hSelectedCertStore de pcsc. Si le nombre de certificats dans le magasin est identique avant et après l’appel de CryptUIDlgSelectCertificate, l’utilisateur a fermé la boîte de dialogue sans sélectionner de certificats.

Notes

Si le membre dwFlags de la structure CRYPTUI_SELECTCERTIFICATE_STRUCT est défini sur CRYPTUI_SELECTCERT_LEGACY, la boîte de dialogue héritée s’affiche. Sinon, la boîte de dialogue de sélection de certificat active s’affiche.

Spécifications

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]
Fin de la prise en charge
Windows 7 [applications de bureau uniquement]
Bibliothèque
Cryptui.lib
DLL
Cryptui.dll
Noms Unicode et ANSI
CryptUIDlgSelectCertificateW (Unicode) et CryptUIDlgSelectCertificateA (ANSI)

Voir aussi

CRYPTUI_SELECTCERTIFICATE_STRUCT