WinTrustSipInitialize  HDRW5S

[New - Windows NT]

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(

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_INFOG4_FST 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 SetLastError34N8_RG function to provide extended error information.

Remarks

The LPWINTRUST_SUBJECT_PACKAGE_INITIALIZE type is a pointer to a WinTrustSipInitialize function.

See Also