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

Статья
08/27/2023

[Функция WintrustAddActionID доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Для проверки сертификата используйте функции CertGetCertificateChain и CertVerifyCertificateChainPolicy . Для проверки подписи технологии Microsoft Authenticode используйте платформа .NET Framework.]

Функция WintrustAddActionID добавляет действие поставщика доверия в систему пользователя. Этот метод следует вызывать во время реализации DllRegisterServer поставщика доверия. У этой функции нет связанной библиотеки импорта. Для динамической связи с Wintrust.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Этот метод должен вызываться только поставщиком доверия.

Синтаксис

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Параметры

[in] pgActionID

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

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

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

Значение	Значение
WINTRUST_ACTION_GENERIC_VERIFY	Проверьте только цепочку сертификатов.
WINTRUST_ACTION_GENERIC_VERIFY_V2	Проверьте файл или объект с помощью поставщика политики Authenticode.
HTTPSPROV_ACTION	Проверьте подключение SSL/PCT через Интернет Обозреватель.

[in] fdwFlags

значение , определяющее, сообщаются ли этой функцией ошибки реестра. Если fdwFlags равно нулю и эта функция испытывает ошибку реестра, ошибка реестра не будет распространена на функцию GetLastError . Если fdwFlags WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) и эта функция вызывает ошибку реестра, ошибка реестра будет распространена на функцию GetLastError .

[in] psProvInfo

Указатель на структуру CRYPT_REGISTER_ACTIONID , которая определяет сведения для поставщика доверия.

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

Если функция выполнена успешно, возвращаемое значение равно TRUE ; FALSE , если функция завершается сбоем. Если функция завершается сбоем, вызовите функцию GetLastError , чтобы определить причину сбоя. Сведения о любых ошибках реестра, с которыми может столкнуться эта функция, см. в описании fdwFlags.

Требования

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

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

WintrustRemoveActionID