Função CryptUIDlgSelectCertificate

A função CryptUIDlgSelectCertificate apresenta uma caixa de diálogo que permite ao utilizador selecionar um certificado.

Sintaxe

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parâmetros

PCSC [em]

Um apontador para uma estrutura CRYPTUI_SELECTCERTIFICATE_STRUCT que contém informação sobre a caixa de diálogo a mostrar.

Valor de retorno

Um ponteiro para uma estrutura CERT_CONTEXT que representa o certificado selecionado pelo utilizador. Quando terminar de usar este certificado, deve passar este ponteiro para a função CertFreeCertificateContext para decrementar a contagem de referências do contexto do certificado.

Se o membro dwFlags da estrutura pcsc não contiver a flag CRYPTUI_SELECTCERT_MULTISELECT , um valor de retorno de NULL significa que o utilizador fechou a caixa de diálogo sem selecionar um certificado.

Se o membro dwFlags da estrutura pcsc contiver a flag CRYPTUI_SELECTCERT_MULTISELECT , esta função devolve sempre NULL. Os certificados selecionados estarão contidos na loja de certificados que é representada pelo membro hSelectedCertStore do pcsc. Se o número de certificados na loja for o mesmo antes e depois de chamar o CryptUIDlgSelectCertificate, o utilizador fechou a caixa de diálogo sem selecionar quaisquer certificados.

Remarks

Se o membro dwFlags da estrutura de CRYPTUI_SELECTCERTIFICATE_STRUCT estiver definido para CRYPTUI_SELECTCERT_LEGACY, o diálogo legado é exibido. Caso contrário, o diálogo atual de seleção de certificados é exibido.

Requirements

Ver também

CRYPTUI_SELECTCERTIFICATE_STRUCT