Функция WinVerifyTrustEx (wintrust.h)

Функция WinVerifyTrustEx выполняет действие проверки доверия для указанного объекта и принимает указатель на структуру WINTRUST_DATA . Функция передает запрос поставщику доверия, если он существует, который поддерживает идентификатор действия.

Для проверки сертификата используйте функции CertGetCertificateChain и CertVerifyCertificateChainPolicy .

Синтаксис

long WinVerifyTrustEx(
  [in] HWND          hwnd,
  [in] GUID          *pgActionID,
  [in] WINTRUST_DATA *pWinTrustData
);

Параметры

[in] hwnd

Необязательный дескриптор в окне вызывающего средства. Поставщик доверия может использовать это значение, чтобы определить, может ли он взаимодействовать с пользователем. Однако поставщики доверия обычно выполняют действия проверки без ввода данных от пользователя.

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

[in] pgActionID

Указатель на структуру GUID , которая определяет действие и поставщик доверия , поддерживающий это действие. Это значение указывает тип действия проверки, выполняемого в структуре, на которую указывает pWinTrustData.

Служба WinTrust предназначена для работы с поставщиками доверия, реализованными сторонними поставщиками. Каждый поставщик доверия предоставляет собственный уникальный набор идентификаторов действий. Сведения об идентификаторах действий, поддерживаемых поставщиком доверия, см. в документации для этого поставщика доверия.

Например, корпорация Майкрософт предоставляет поставщик доверия издателя программного обеспечения, который может установить надежность скачивания программного обеспечения из Интернета или другой общедоступной сети. Поставщик доверия издателя программного обеспечения поддерживает следующие идентификаторы действий. Эти константы определены в Softpub.h.

[in] pWinTrustData

Указатель на структуру WINTRUST_DATA , содержащую сведения, необходимые поставщику доверия для обработки указанного идентификатора действия. Как правило, структура содержит сведения, определяющие объект, который должен оценивать поставщик доверия.

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

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

Обратите внимание, что возвращаемый тип объявлен как HRESULT этот API возвращает коды ошибок Win32, не используйте SUCCEEDED() или FAILED() для проверки результата.

Если поставщик доверия проверяет, является ли субъект доверенным для указанного действия, возвращаемое значение ERROR_SUCCESS. В противном случае функция возвращает код состояния от поставщика доверия.

Например, поставщик доверия может указать, что субъект не является доверенным или доверенным, но с ограничениями или предупреждениями. Возвращаемое значение может быть конкретным поставщиком доверия, описанным в документации для отдельного поставщика доверия, или может быть одним из следующих кодов ошибок.

Требования