Função CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

Artigo
03/05/2024

A função CryptUIDlgSelectCertificateFromStore exibe uma caixa de diálogo que permite a seleção de um certificado de um repositório especificado.

Sintaxe

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

Parâmetros

[in] hCertStore

Identificador do repositório de certificados a ser pesquisado.

[in] hwnd

Identificador da janela para a exibição. Se NULL, o padrão será a janela da área de trabalho.

[in, optional] pwszTitle

Cadeia de caracteres usada como o título da caixa de diálogo. Se NULL, o título padrão, "Selecionar Certificado", será usado.

[in, optional] pwszDisplayString

Instrução text na caixa de diálogo de seleção. Se NULL, a frase padrão , "Selecionar um certificado que você deseja usar", será usada.

[in] dwDontUseColumn

Sinalizadores que podem ser combinados para excluir colunas da exibição.

Valor	Significado
CRYPTUI_SELECT_ISSUEDTO_COLUMN	Não exiba as informações ISSUEDTO.
CRYPTUI_SELECT_ISSUEDBY_COLUMN	Não exiba as informações ISSUEDBY.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN	Não exiba IntendedUse information.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN	Não exiba as informações de nome de exibição.
CRYPTUI_SELECT_LOCATION_COLUMN	Não exiba informações de localização.
CRYPTUI_SELECT_EXPIRATION_COLUMN	Não exiba informações de expiração.

[in] dwFlags

Atualmente, não é usado e deve ser definido como 0.

[in] pvReserved

Reservado para uso futuro.

Retornar valor

Retorna um ponteiro para o contexto de certificado selecionado. Se nenhum certificado tiver sido selecionado, NULL será retornado. Quando terminar de usar o certificado, libere o contexto do certificado chamando a função CertFreeCertificateContext .

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]
Plataforma de Destino	Windows
Cabeçalho	cryptuiapi.h
Biblioteca	Cryptui.lib
DLL	Cryptui.dll

Confira também

CryptUIDlgViewContext

Compartilhar via