WinTrustSipInitialize info

The WinTrustSipInitialize function is an initialization function that WinTrust calls when it loads a Subject Interface Package (SIP) DLL. Each SIP must export a WinTrustSipInitialize function.

BOOL WinTrustSipInitialize(

DWORD dwWinTrustRevision,	// WinTrust revision level
LPWINTRUST_SIP_INFO *lpSipInfo	// receives a pointer to a SIP information structure
);

Parameters

dwWinTrustRevision

Indicates the revision level of the WinTrust component that calls this function. WinTrust sets this value to WIN_TRUST_REVISION_1_0.

lpSipInfo

Pointer to a variable that receives a pointer to a buffer allocated by the SIP. The buffer contains a WINTRUST_SIP_INFO structure that describes the SIP. WinTrust continues to reference this buffer until it unloads the SIP. The SIP 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 SIP successfully initializes itself, the return value is a nonzero value.

If the SIP did not successfully initialize itself, the return value is zero. In this case, WinTrust makes no further calls to the SIP. The SIP can use the SetLastError function to provide extended error information.

Remarks

The LPWINTRUST_SUBJECT_PACKAGE_INITIALIZE type is a pointer to a WinTrustSipInitialize function.

See Also

WINTRUST_SIP_INFO