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

Confira também

CRYPTUI_SELECTCERTIFICATE_STRUCT