Функция 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, отображается устаревшее диалоговое окно. В противном случае откроется диалоговое окно выбора текущего сертификата.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Дата окончания поддержки
 Windows 7 [только классические приложения]
Библиотека
Cryptui.lib
DLL
Cryptui.dll
Имя в кодировке Юникод и ANSI
 CryptUIDlgSelectCertificateW (Юникод) и CryptUIDlgSelectCertificateA (ANSI)

См. также раздел

CRYPTUI_SELECTCERTIFICATE_STRUCT