Функция CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

  • Статья

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

Синтаксис

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
);

Параметры

[in] hCertStore

Дескриптор хранилища сертификатов для поиска.

[in] hwnd

Дескриптор окна для отображения. Если значение РАВНО NULL, по умолчанию используется окно рабочего стола.

[in, optional] pwszTitle

Строка, используемая в качестве заголовка диалогового окна. Если задано значение NULL, используется заголовок по умолчанию "Выбор сертификата".

[in, optional] pwszDisplayString

Оператор Text в диалоговом окне выбора. Если задано значение NULL, используется фраза по умолчанию "Выберите сертификат, который вы хотите использовать".

[in] dwDontUseColumn

Флаги, которые можно объединить для исключения столбцов отображения.

Значение Значение
CRYPTUI_SELECT_ISSUEDTO_COLUMN
 Не отображайте данные ISSUEDTO.
CRYPTUI_SELECT_ISSUEDBY_COLUMN
 Не отображайте данные ISSUEDBY.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN
 Не отображать сведения о предполагаемом использовании.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN
 Не отображайте сведения о отображаемом имени.
CRYPTUI_SELECT_LOCATION_COLUMN
 Не отображать сведения о расположении.
CRYPTUI_SELECT_EXPIRATION_COLUMN
 Не выводить сведения об истечении срока действия.

[in] dwFlags

В настоящее время не используется и должен иметь значение 0.

[in] pvReserved

Зарезервировано для последующего использования.

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

Возвращает указатель на выбранный контекст сертификата. Если сертификат не выбран, возвращается значение NULL . Завершив использование сертификата, освободите контекст сертификата, вызвав функцию CertFreeCertificateContext .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header cryptuiapi.h
Библиотека Cryptui.lib
DLL Cryptui.dll

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

CryptUIDlgViewContext