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
);

Parameters

pcsc [in]

Um ponteiro para uma estrutura CRYPTUI_SELECTCERTIFICATE_STRUCT que contém informações sobre a caixa de diálogo a ser exibida.

Valor de retorno

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 diminuir 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 significa 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 serã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.

Requirements

Consulte também

CRYPTUI_SELECTCERTIFICATE_STRUCT