Microsoft Internet Security and Acceleration Server 2004 SDK |
The GetWPXFilterVersion function is called after the GetFilterVersion function (if it is implemented) to get notifications specific to ISA Server 2004. The Web proxy passes a pointer to an HTTP_FILTER_VERSION data structure, which can be used to supply key filter configuration information to the Web proxy. The most important information passed to the Web proxy is the bitmask that contains flags that specify which notification events your filter can process, and a flag that indicates the overall processing priority for your filter. This function must be implemented together with HttpWPXFilterProc.
This function is used to set the new notifications available in ISA Server 2004. To set the notifications that were available to ISAPI filters in ISA Server 2000 and Internet Information Services (IIS), use GetFilterVersion.
The function declaration is:
BOOL WINAPI GetWPXFilterVersion( PHTTP_FILTER_VERSION pVer );
If this function returns TRUE, the filter will remain loaded. If the function returns FALSE, the filter functionality will be terminated and the filter will be unloaded. If the function returns FALSE in your filter, the filter must call SetLastError with the nature of the failure.
Note It is important to register only for those notifications that are necessary for your filter's purposes. Registering for additional notifications will reduce performance.
At a minimum, a Web filter must implement either GetFilterVersion and HttpFilterProc, or GetWPXFilterVersion and HttpWPXFilterProc (or both pairs of functions).
Server: Requires Windows Server 2003 or
Windows 2000.
Version: Requires Internet Security and Acceleration
Server 2004.
Header: Declared in Wpxhttpfilt.h.