GetFilterVersion (Windows Embedded CE 6.0)

1/6/2010

This function is an application-defined function. It is the first entry-point function called by the Web Server on your ISAPI filter, and must be present for the filter to work properly. The Web Server passes a pointer to an HTTP_FILTER_VERSION structure, which can be used to supply important filter configuration information to the Web Server. The most important information passed to the Web Server 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. The GetFilterVersion name for this function is a placeholder for the function name defined by the header.

Syntax

BOOL WINAPI GetFilterVersion(
  PHTTP_FILTER_VERSION pVer
);

Parameters

• pVer
  [out] Pointer to the HTTP_FILTER_VERSION structure that contains both the version information for the server and members with which the filter can indicate filter version number, notifications, and priority desired.

Return Value

Returns TRUE if the function succeeds, and FALSE otherwise. This function must return TRUE for the filter to remain loaded and working properly.

Remarks

Due to performance considerations, it is important to register only for those notifications that are necessary for your filter's purposes.

Requirements

See Also

Reference

Web Server Functions
HttpFilterProc
HTTP_FILTER_VERSION