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 |
|
| DLL |
|
| Noms Unicode et ANSI |
CryptUIDlgSelectCertificateW (Unicode) et CryptUIDlgSelectCertificateA (ANSI) |