[New - Windows NT]
WinTrustProviderVerifyTrust功能对指定的主题执行指定的验证操作。当应用程序调用{??989796013}函数时,WinTrust调用支持指定操作标识符的信任提供者的WinTrustProviderVerifyTrust功能。
LONG WinTrustProviderVerifyTrust(
HWND 【HWND】, | //处理与用户进行交互的窗口 |
GUID *【ActionID】, | //指向信任提供者操作标识符的指针 |
LPVOID 【ActionData】 | //指向特定于动作的数据结构的指针 |
); |
参数
【HWND】
处理来电者的窗口。信任提供者可以使用该值来确定它是否可以与用户交互以执行由动作标识符指示的验证操作。然而,信任提供者通常执行验证操作而不需要用户的输入。此参数可以是以下值之一。
值 | 含义 |
INVALID_HANDLE_VALUE | 没有互动用户。信任提供者在没有用户帮助的情况下执行验证操作。 |
零 | 信任提供者可以使用交互式桌面显示其用户界面。 |
一个有效的窗口句柄 | 信任提供者可以假定除零或INVALID_HANDLE_VALUE之外的任何值都是一个有效的窗口句柄,它可以用来与用户进行交互。 |
【ActionID】
指向GUID结构的指针,用于标识要执行的操作。每个信任提供者都支持一组唯一的动作标识符。信任提供者确定由【ActionData】参数标识的主题是否被信任指定的操作。
【ActionData】
指向包含信任提供者处理指定操作标识符所需的信息的缓冲区。通常,缓冲区中的数据包括标识信任提供者必须评估的主题的信息。缓冲区的格式和内容取决于操作标识符和信任提供者。
返回值
如果信任提供者验证主题是否受指定操作的信任,则返回值为ERROR_SUCCESS。
否则,返回值是指示发生错误的状态代码。例如,信任提供者可能会指出主体不受信任,或被信任,但有限制或警告。返回值可以是单个信任提供者的文档中描述的信任提供者特定值,也可以是WINERROR.H中定义的以下错误代码之一。
值 | 含义 |
TRUST_E_SUBJECT_NOT_TRUSTED | 该指定的操作不受信任。大多数信任提供者返回更详细的错误代码,描述主题不受信任的原因。 |
TRUST_E_ACTION_UNKNOWN | 信任提供者不支持指定的操作。 |
TRUST_E_SUBJECT_FORM_UNKNOWN | 信任提供者不支持为主题指定的表单。 |
备注
每个信任提供者DLL都必须实现WinTrustProviderVerifyTrust功能。当WinTrust调用信任提供者的WinTrustProviderClientInitialize初始化函数时,WinTrust获取指向信任提供者的WinTrustProviderVerifyTrust实现的指针。
信任提供者的WinTrustProviderVerifyTrust函数在调用WinVerifyTrust函数的应用程序的过程中执行。该函数也在应用程序的安全上下文中执行。
LPWINTRUST_PROVIDER_VERIFY_TRUST类型是指向WinTrustProviderVerifyTrust函数的指针。
也可以看看