WinTrustProviderServerInitialize info

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

WINTRUST_PROVIDER_SERVER_INFO, WINTRUST_SERVER_TP_INFO