CryptUIDlgSelectCertificate-funktion

Funktionen CryptUIDlgSelectCertificate visar en dialogruta där en användare kan välja ett certifikat.

Syntax

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parameters

pcsc [in]

En pekare till en CRYPTUI_SELECTCERTIFICATE_STRUCT struktur som innehåller information om dialogrutan som ska visas.

Returvärde

En pekare till en CERT_CONTEXT struktur som representerar certifikatet som användaren har valt. När du är klar med det här certifikatet måste du skicka den här pekaren till funktionen CertFreeCertificateContext för att minska referensantalet för certifikatkontexten.

Om dwFlags-medlemmen i pcsc-strukturen inte innehåller flaggan CRYPTUI_SELECTCERT_MULTISELECT innebär ett returvärde för NULL att användaren stängde dialogrutan utan att välja ett certifikat.

Om dwFlags-medlemmen i pcsc-strukturen innehåller flaggan CRYPTUI_SELECTCERT_MULTISELECT returnerar den här funktionen alltid NULL. De valda certifikaten kommer att finnas i certifikatarkivet som representeras av hSelectedCertStore-medlemmen i pcsc. Om antalet certifikat i arkivet är detsamma före och efter anropet av CryptUIDlgSelectCertificate stängde användaren dialogrutan utan att välja några certifikat.

Remarks

Om dwFlags-medlemmen i CRYPTUI_SELECTCERTIFICATE_STRUCT-strukturen är inställd på CRYPTUI_SELECTCERT_LEGACY visas den äldre dialogrutan. Annars visas den aktuella dialogrutan för val av certifikat.

Requirements

Krav Value
Lägsta klient som stöds
Windows XP [endast skrivbordsappar]
Lägsta server som stöds
Windows Server 2003 [endast skrivbordsappar]
Stöd upphör
Windows 7 [endast skrivbordsappar]
Library
Cryptui.lib
DLL
Cryptui.dll
Unicode- och ANSI-namn
CryptUIDlgSelectCertificateW (Unicode) och CryptUIDlgSelectCertificateA (ANSI)

Se även

CRYPTUI_SELECTCERTIFICATE_STRUCT