WinTrustProviderClientInitialize

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

WinTrustProviderClientInitialize函数是WinTrust在加载信任提供者DLL的客户端组件时调用的初始化函数。每个信任提供者必须导出WinTrustProviderClientInitialize函数。

BOOL WinTrustProviderClientInitialize(

DWORD 【dwWinTrustRevision】,// WinTrust修订级别
LPWINTRUST_CLIENT_TP_INFO 【lpWinTrustInfo】,//指向WinTrust信息的指针
LPWSTR 【lpProviderName】,//管理员分配的信任提供者的名称
LPWINTRUST_PROVIDER_CLIENT_INFO *【lpTrustProviderInfo】//接收有关信任提供者的信息
); 

参数

【dwWinTrustRevision】

表示调用此函数的WinTrust组件的修订级别。WinTrust将此值设置为WIN_TRUST_REVISION_1_0。

【lpWinTrustInfo】

指向包含WinTrust传递给信任提供程序的信息的WINTRUST_CLIENT_TP_INFO结构。该结构包括由WinTrust实现的功能的分发表,供由信任提供者的客户端组件使用。

此缓冲区中的信息为只读。它直到信任提供者DLL被卸载才有效。信任提供者可以引用信息而不是复制信息。

【lpProviderName】

指向包含信任提供程序名称的以null结尾的Unicode字符串。系统管理员将此名称分配给用于存储信任提供程序的配置信息的注册表项。该指针是只读的,并且有效,直到信任提供者DLL被卸载为止。信任提供者可以引用信息而不是复制信息。

【lpTrustProviderInfo】

指向接收由信任提供者分配的缓冲区的指针的变量的指针。该缓冲区包含一个WINTRUST_PROVIDER_CLIENT_INFO结构,其中包含有关信任提供者的信息。该信息包括信任提供者的修订级别,调度表以及标识信任提供商支持的操作标识符的GUID的数组。WinTrust将缓冲区视为只读,并继续引用此缓冲区,直到它卸载信任提供程序DLL。信任提供者不得更改缓冲区中的信息,或者在卸载之前取消分配内存;这样做可能会破坏系统。

返回值

如果函数成功,则返回值为非零值。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

当WinTrust加载信任提供者时,它会调用信任提供者的WinTrustProviderClientInitialize函数。这使得信任提供者有机会自己初始化,并在WinTrust和信任提供者之间交换信息。

LPWINTRUST_PROVIDER_CLIENT_INITIALIZE类型是指向WinTrustProviderClientInitialize函数的指针。

也可以看看

WINTRUST_CLIENT_TP_INFO, WINTRUST_PROVIDER_CLIENT_INFO