Função CryptUIDlgSelectCertificate
A função CryptUIDlgSelectCertificate exibe uma caixa de diálogo que permite que um usuário selecione um certificado.
Sintaxe
PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
_In_ PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);
Parâmetros
-
pcsc [in]
-
Um ponteiro para uma estrutura de CRYPTUI_SELECTCERTIFICATE_STRUCT que contém informações sobre a caixa de diálogo a ser exibida.
Valor retornado
Um ponteiro para uma estrutura de CERT_CONTEXT que representa o certificado selecionado pelo usuário. Quando terminar de usar esse certificado, você deve passar esse ponteiro para a função CertFreeCertificateContext para decrementar a contagem de referência do contexto do certificado.
Se o membro dwFlags da estrutura pcsc não contiver o sinalizador CRYPTUI_SELECTCERT_MULTISELECT , um valor retornado de NULL significará que o usuário fechou a caixa de diálogo sem selecionar um certificado.
Se o membro dwFlags da estrutura pcsc contiver o sinalizador CRYPTUI_SELECTCERT_MULTISELECT , essa função sempre retornará NULL. Os certificados selecionados estarão contidos no repositório de certificados representado pelo membro hSelectedCertStore do pcsc. Se o número de certificados no repositório for o mesmo antes e depois de chamar CryptUIDlgSelectCertificate, o usuário fechou a caixa de diálogo sem selecionar nenhum certificado.
Comentários
Se o membro dwFlags da estrutura CRYPTUI_SELECTCERTIFICATE_STRUCT estiver definido como CRYPTUI_SELECTCERT_LEGACY, a caixa de diálogo herdada será exibida. Caso contrário, a caixa de diálogo de seleção de certificado atual será exibida.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Fim do suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
CryptUIDlgSelectCertificateW (Unicode) e CryptUIDlgSelectCertificateA (ANSI) |