WinTrustSipInitialize

Quick Info

Windows NT
Yes
Win95
No
Win32s
No
Import Library
-
Header File
wintrust.h
Unicode
No
Platform Notes
None

[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(

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.