Функция CryptUIDlgSelectCertificate

Функция CryptUIDlgSelectCertificate отображает диалоговое окно, позволяющее пользователю выбрать сертификат.

Синтаксис

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Параметры

pcsc [in]

Указатель на структуру CRYPTUI_SELECTCERTIFICATE_STRUCT , содержащую сведения о диалоговом окне для отображения.

Возвращаемое значение

Указатель на структуру CERT_CONTEXT , представляющую сертификат, выбранный пользователем. Завершив использование этого сертификата, необходимо передать этот указатель в функцию CertFreeCertificateContext для уменьшения количества ссылок контекста сертификата.

Если элемент dwFlags структуры pcsc не содержит флаг CRYPTUI_SELECTCERT_MULTISELECT , возвращаемое значение NULL означает, что пользователь закрыл диалоговое окно без выбора сертификата.

Если элемент dwFlags структуры pcsc содержит флаг CRYPTUI_SELECTCERT_MULTISELECT , эта функция всегда возвращает значение NULL. Выбранные сертификаты будут содержаться в хранилище сертификатов, представленном членом hSelectedCertStorepcsc. Если число сертификатов в хранилище совпадает с числом сертификатов до и после вызова CryptUIDlgSelectCertificate, пользователь закрыл диалоговое окно без выбора сертификатов.

Замечания

Если для элемента dwFlags структуры CRYPTUI_SELECTCERTIFICATE_STRUCT задано значение CRYPTUI_SELECTCERT_LEGACY, отображается устаревшее диалоговое окно. В противном случае отображается диалоговое окно выбора текущего сертификата.

Требования

См. также

CRYPTUI_SELECTCERTIFICATE_STRUCT