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

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

[in] fdwFlags

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

[in] psProvInfo

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

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

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

Комментарии

Чтобы удалить действие, добавленное этой функцией, вызовите функцию WintrustRemoveActionID .

Требования

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

WintrustRemoveActionID