структура CRYPTUI_VIEWCERTIFICATE_STRUCTA (cryptuiapi.h)

Статья
11/20/2024

Структура CRYPTUI_VIEWCERTIFICATE_STRUCT содержит сведения о сертификате для просмотра. Эта структура используется в функции CryptUIDlgViewCertificate.

Синтаксис

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCSTR            szTitle;
  PCCERT_CONTEXT    pCertContext;
  LPCSTR            *rgszPurposes;
  DWORD             cPurposes;
  union {
    CRYPT_PROVIDER_DATA const *pCryptProviderData;
    HANDLE                    hWVTStateData;
  };
  BOOL              fpCryptProviderDataTrustedUsage;
  DWORD             idxSigner;
  DWORD             idxCert;
  BOOL              fCounterSigner;
  DWORD             idxCounterSigner;
  DWORD             cStores;
  HCERTSTORE        *rghStores;
  DWORD             cPropSheetPages;
  LPCPROPSHEETPAGEA rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;

Члены

dwSize

Размер структуры CRYPTUI_VIEWCERTIFICATE_STRUCT в байтах.

hwndParent

Дескриптор окна, который является родительским элементом диалогового окна, созданногоCryptUIDlgViewCertificate.

dwFlags

Этот элемент может быть одним или несколькими из следующих значений.

Ценность	Значение
CRYPTUI_HIDE_HIERARCHYPAGE	Страница пути сертификации отключена.
CRYPTUI_HIDE_DETAILPAGE	Страница сведений отключена.
CRYPTUI_DISABLE_EDITPROPERTIES	Пользователю не разрешено изменять свойства.
CRYPTUI_ENABLE_EDITPROPERTIES	Пользователь может изменить свойства.
CRYPTUI_DISABLE_ADDTOSTORE	Кнопка установки отключена.
CRYPTUI_ENABLE_ADDTOSTORE	Кнопка Установить включена.
CRYPTUI_ACCEPT_DECLINE_STYLE	Страницы или кнопки, позволяющие пользователю принимать или отклонять любое решение, отключаются.
CRYPTUI_IGNORE_UNTRUSTED_ROOT	Недоверенная корневая ошибка игнорируется.
CRYPTUI_DONT_OPEN_STORES	Известные доверенные хранилища не будут использоваться для создания цепочки.
CRYPTUI_ONLY_OPEN_ROOT_STORE	Известное доверенное корневое хранилище не будет использоваться для создания цепочки.
CRYPTUI_WARN_UNTRUSTED_ROOT	Используйте только при просмотре сертификатов на удаленных компьютерах. Если этот флаг используется, первый элемент rghStores должен быть дескриптором корневого хранилища на удаленном компьютере.
CRYPTUI_ENABLE_REVOCATION_CHECKING	Включите проверку отзыва с поведением по умолчанию. Поведение по умолчанию — включить проверку отзыва всей цепочки сертификатов, кроме корневого сертификата. Допустимо, только если ни pCryptProviderData, ни hWVTStateData член объединения.
CRYPTUI_WARN_REMOTE_TRUST	При создании цепочки сертификатов для удаленного компьютера предупреждают, что цепочка может не доверять на удаленном компьютере.
CRYPTUI_DISABLE_EXPORT	Если этот флаг задан, кнопка "Копировать в файл" будет отключена на странице сведений.
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT	Включите проверку отзыва только на конечный сертификат в цепочке сертификатов. Допустимо, только если ни pCryptProviderData, ни hWVTStateData член объединения.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN	Включите проверку отзыва для каждого сертификата в цепочке сертификатов. Допустимо, только если ни pCryptProviderData, ни hWVTStateData член объединения. Примечание Поскольку корневые сертификаты редко содержат информацию, которая позволяет проверять отзыв, ожидается, что использование этого параметра обычно приведет к сбою функции CryptUIDlgViewCertificate. Рекомендуется использовать CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT	Включите проверку отзыва для каждого сертификата в цепочке сертификатов, за исключением корневого сертификата. Это рекомендуемый вариант для проверки отзыва сертификатов. Допустимо, только если ни pCryptProviderData, ни hWVTStateData член объединения. примечание Этот флаг эквивалентен CRYPTUI_ENABLE_REVOCATION_CHECKING.
CRYPTUI_DISABLE_HTMLLINK	Отключите кнопку справки HTML (?) в диалоговом окне сертификатов.
CRYPTUI_DISABLE_ISSUERSTATEMENT	Отключите кнопку инструкции издателя на вкладке общие диалогового окна сертификата .
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL	Отключите проверку отзыва через Интернет. Установите этот флаг, чтобы убедиться, что функция CryptUIDlgViewCertificate использует локальный кэш для получения сертификата и не пытается получить сертификат из сети. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: этот флаг не поддерживается.

szTitle

Указатель на строку, завершающую значение NULL, содержащую заголовок окна.

pCertContext

Указатель на структуру CERT_CONTEXT, содержащую контекст сертификата для отображения.

rgszPurposes

Массив указателей на строки, завершаемые значением NULL, содержащие цели, для которых будет проверен этот сертификат.

cPurposes

Количество целей в массиве rgszPurposes.

pCryptProviderData

Если функция WinVerifyTrust уже была вызвана для сертификата, а функция WTHelperProvDataFromStateData также была вызвана, передайте указатель на структуру состояния, полученную из вызова WTHelperProvDataFromStateData. Если pCryptProviderData задано, fpCryptProviderDataTrustedUsage, idxSigner, idxCertи fCounterSignature.

hWVTStateData

Если WinVerifyTrust уже был вызван для сертификата и WTHelperProvDataFromStateData, передайте hWVTStateData член структуры WINTRUST_DATA. Если hWVTStateData задано, fpCryptProviderDataTrustedUsage, idxSigner, idxCertи fCounterSignature также необходимо задать.

fpCryptProviderDataTrustedUsage

Если был вызван WinVerifyTrust, это результат того, является ли сертификат доверенным.

idxSigner

Индекс подписыватель для просмотра.

idxCert

Индекс сертификата, который просматривается в цепочке подписывания. Контекст сертификата должен соответствовать pCertContext.

fCounterSigner

TRUE, если отображается счетчик. Если это TRUE, idxCounterSigner должен быть допустимым.

idxCounterSigner

Индекс счетчика для просмотра.

cStores

Количество других хранилищ в rghStores массиве хранилищ сертификатов для поиска при создании и проверке цепочки сертификатов.

rghStores

Массив HCERTSTORE обрабатывает другие хранилища сертификатов для поиска при создании и проверке цепочки сертификатов.

cPropSheetPages

Количество страниц свойств, добавляемых в диалоговое окно.

rgPropSheetPages

Массив страниц свойств, добавляемых в диалоговое окно. Каждая страница в этом массиве не получит lParam в структуре PROPSHEETPAGE в виде lParam в сообщении WM_INITDIALOG. Вместо этого он получит указатель на структуру CRYPTUI_INITDIALOG_STRUCT. Он содержит lParam в PROPSHEETPAGE и указатель на CERT_CONTEXT, для которого отображается страница.

nStartPage

Индекс начальной страницы, отображаемой. Если задан самый высокий бит (0x8000), индекс предполагается индексировать rgPropSheetPages (после того, как самый высокий бит был удален, например, 0x8000 будет указывать первую страницу в rgPropSheetPages). Если самый высокий бит равен нулю, nStartPage будет начальным индексом страниц свойств диалогового окна сертификата по умолчанию.

Замечания

Заметка

Заголовок cryptuiapi.h определяет CRYPTUI_VIEWCERTIFICATE_STRUCT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	cryptuiapi.h

См. также

CryptUIDlgViewCertificate

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