WintrustAddActionID 函数 (wintrust.h)

  • 项目

[ WintrustAddActionID 函数可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 对于证书验证，请使用 CertGetCertificateChain 和 CertVerifyCertificateChainPolicy 函数。 对于 Microsoft Authenticode 技术签名验证，请使用 .NET Framework。]

WintrustAddActionID 函数将信任提供程序操作添加到用户的系统。 应在信任提供程序的 DllRegisterServer 实现过程中调用此方法。 此函数没有关联的导入库。 必须使用 LoadLibrary 和 GetProcAddress 函数动态链接到 Wintrust.dll。

只能由信任提供程序调用此方法。

语法

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

参数

[in] pgActionID

指向 GUID 结构的指针，该结构标识要添加的操作和支持该操作 的信任提供程序 。

WinTrust 服务旨在与由第三方实现的信任提供程序配合使用。 每个信任提供程序都提供其自己唯一的操作标识符集。 有关信任提供程序支持的操作标识符的信息，请参阅该信任提供程序的文档。

例如，Microsoft 提供了一个软件发布者信任提供程序，该提供程序可以建立从 Internet 或其他一些公共网络下载的软件的可信度。 软件发布者信任提供程序支持以下操作标识符。 这些常量在 Softpub.h 中定义。

值 含义
WINTRUST_ACTION_GENERIC_VERIFY
 仅验证证书链。
WINTRUST_ACTION_GENERIC_VERIFY_V2
 使用 Authenticode 策略提供程序验证文件或对象。
HTTPSPROV_ACTION
 通过 Internet Explorer 验证 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 的说明。

注解

若要删除此函数添加的操作，请调用 WintrustRemoveActionID 函数。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wintrust.h
Library Wintrust.lib
DLL Wintrust.dll

另请参阅

WintrustRemoveActionID