WinVerifyTrustEx 函数 （wintrust.h）

WinVerifyTrustEx 函数对指定对象执行信任验证作，并获取指向WINTRUST_DATA结构的指针。 该函数将查询传递给支持作标识符 的信任提供程序（如果存在）。

对于证书验证，请使用 CertGetCertificateChain 和 CertVerifyCertificateChainPolicy 函数。

Syntax

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

参数

[in] hwnd

调用方窗口的可选句柄。 信任提供程序可以使用此值来确定它是否可以与用户交互。 但是，信任提供程序通常执行验证作，而无需用户输入。

此参数可以是下列值之一。

[in] pgActionID

指向 GUID 结构的指针，该结构标识作和支持该作的信任 提供程序 。 此值指示要在 pWinTrustData 指向的结构上执行的验证作的类型。

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

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

[in] pWinTrustData

指向 WINTRUST_DATA 结构的指针，该结构包含 信任提供程序 处理指定作标识符所需的信息。 通常，该结构包含用于标识信任提供程序必须评估的对象的信息。

结构的格式取决于作标识符。 有关特定作标识符所需的数据的信息，请参阅支持该作的信任提供程序的文档。

返回值

请注意，虽然返回类型声明为 HRESULT，但此 API 返回 Win32 错误代码，请勿使用 SUCCEEDED（） 或 FAILED（）来测试结果。

如果信任提供程序验证使用者是否信任指定的作，则返回值ERROR_SUCCESS。 否则，该函数从 信任提供程序返回状态代码。

例如，信任提供程序可能指示主题不受信任，或者受信任，但存在限制或警告。 返回值可以是单个信任提供程序文档中描述的信任提供程序特定值，也可以是以下错误代码之一。

要求