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

Статья
08/22/2023

Функция 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

Поделиться через