Compartilhar via

Função CryptUIDlgSelectCertificate

  • Artigo

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
Cryptui.lib
DLL
Cryptui.dll
Nomes Unicode e ANSI
 CryptUIDlgSelectCertificateW (Unicode) e CryptUIDlgSelectCertificateA (ANSI)

Confira também

CRYPTUI_SELECTCERTIFICATE_STRUCT