WinTrustProviderServerInitialize
[New
- Windows NT]
The WinTrustProviderServerInitialize
function is an initialization function that WinTrust calls when it loads the
server component of a trust provider DLL.
The current
release of WinTrust does not include the WinTrust server component.
Consequently, WinTrust does not call this function and trust provider DLLs do
not need to export it.
BOOL
WinTrustProviderServerInitialize(
|
DWORD dwWinTrustRevision, |
// WinTrust revision level |
|
LPWINTRUST_SERVER_TP_INFO lpWinTrustInfo, |
// pointer to information about WinTrust |
|
LPWSTR lpProviderName, |
// pointer to the name of the trust provider |
|
LPWINTRUST_PROVIDER_SERVER_INFO
*lpTrustProviderInfo |
// pointer to buffer that receives information about
the trust provider |
|
); |
|
Parameters
dwWinTrustRevision
Indicates the
revision level of the WinTrust component that calls this function. WinTrust
sets this value to WIN_TRUST_REVISION_1_0.
lpWinTrustInfo
Pointer to a WINTRUST_SERVER_TP_INFO structure that contains information
that WinTrust passes to the trust provider. This structure includes a dispatch
table of functions implemented by WinTrust for use by the server component of a
trust provider.
The
information in this buffer is read-only. It is valid until the trust provider
DLL is unloaded. The trust provider can reference the information rather than
copy it.
lpProviderName
Pointer to a
null-terminated Unicode string that contains the name that the system
administrator assigned to the registry key that stores configuration
information for the trust provider. The pointer is read-only and valid until
the trust provider DLL is unloaded. The trust provider can reference the
information rather than copy it.
lpTrustProviderInfo
Pointer to a
variable that receives a pointer to a buffer allocated by the trust provider.
The buffer contains a WINTRUST_PROVIDER_SERVER_INFO structure with information
about the trust provider. The information includes the revision level of the
trust provider and a dispatch table. WinTrust treats the buffer as read-only,
and continues to reference this buffer until it unloads the trust provider DLL.
The trust provider must not change the information in the buffer, or deallocate
the memory before it is unloaded; doing so could corrupt the system.
Return Values
If the
function succeeds, the return value is a nonzero value.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The
LPWINTRUST_PROVIDER_SERVER_INITIALIZE type is a pointer to a WinTrustProviderServerInitialize
function.
See Also