个Filter提供的GetFilterVersion( )函数，获得版本号以及该Filter希望
处理的事件，即ISAPI Filter通过引出GetFilterVersion( )函数来告知服务器自己希望处理什
么类型的事件，因为ISAPI Filter是通过事件来激活的，当满足条件的事件到达时，服务器就会
调用Filter引出的主函数HttpFilterProc( )对该事件进行处理。GetFilterVersion( )的原型如
下：
BOOL WINAPI GetFilterVersion(
DWORD dwServerFilterVersion; //IN，服务器使用的版本规范
DWORD dwFilterVersion; //OUT，过滤器使用的版本规范
CHAR lpszFilterDesc[SF_MAX_FILTER_DESC_LEN+1]; //OUT，对该过滤器的描述字符串
DWORD dwFlags //OUT，事件和优先级标志
)；
事件和优先级标志dwFlasg的取值在MSDN中有详细解释，其中包括该Filter被调用的优先级，一
般应使用默认的低优先级，否则可能会对系统的性能造成很大影响。
3、HttpFilterProc( )是ISAPI Filter主要的入口函数，它根据当前的事件的不同作出不同的处
理。服务器通过如下的参数块和Filter进行交互，这个参数块的作用和ISA中的ECB类似。
typedef struct _HTTP_FILTER_CONTEXT
{
DWORD cbSize; //IN，本参数块的大小
DWORD Revision; //IN
PVOID ServerContext; //IN，由server使用本参数
DWORD ulReserved; //IN，由server使用本参数
BOOL fIsSecurePort; //IN，事件是否发生在安全端口上
PVOID pFilterContext; //IN/OUT，与本次请求相关的上下文
//回调函数，取得关于服务器和本次连接的信息
BOOL (WINAPI * GetServerVariable) (
struct _HTTP_FILTER_CONTEXT * pfc,
LPSTR lpszVariableName,
LPVOID lpvBuffer,
LPDWORD lpdwSize
);
BOOL (WINAPI * AddResponseHeaders) ( //回调函数，给HTTP响应添加一个标头
struct _HTTP_FILTER_CONTEXT * pfc,
LPSTR lpszHeaders,
DWORD dwReserved
);
BOOL (WINAPI * WriteClient) ( //回调函数，将原始数据发送给客户端
struct _HTTP_FILTER_CONTEXT * pfc,
LPVOID Buffer,
LPDWORD lpdwBytes,
DWORD dwReserved
);
VOID * (WINAPI * AllocMem) ( //回调函数，分配内存。
struct _HTTP_FILTER_CONTEXT * pfc,
DWORD cbSize,
DWORD dwReserved
);
BOOL (WINAPI * ServerSupportFunction) ( //回调函数，访问服务器的一般和特定功能
struct _HTTP_FILTER_CONTEXT * pfc,
enum SF_REQ_TYPE sfReq,
PVOID pData,
DWORD ul1,
DWORD ul2
);
} HTTP_FILTER_CONTEXT, *PHTTP_FILTER_CONTEXT;
四、VC++ 6.0中对ISAPI的支持
VC++ 6.0中定义了5个相关的类以简化ISAPI的编程工作：CHttpServer、CHttpServerContext、
CHttpFilter、CHttpFilterContext、CHtmlStream，这5个类都没有父类。其中CHttpServer和
CHttpServerContext主要用来编写ISA，CHttpFilter和CHttpFilterContext则用来编写ISAPI
Filter，而CHtmlStream则用来操作内存中的HTML文件，为其它的4个类提供服务。CHttpServer
在每个ISA中只能有一个实例，一个CHttpServer可以对应多个CHttpServerContext实例，每个
CHttpServerContext处理一个客户请求，这样可以处理并发的HTTP请求；CHttpFilter和
CHttpFilterContext之间的关系与此类似，在每个ISAPI Filter中只能有一个CHttpFilter实例
，但是可以有多个CHttpFilterContext来处理并发的事件。CHttpServer和CHttpFilter是独立的
类，它们可以共存于一个DLL中，也可以分别在不同的DLL中。
一个ISA可以提供多个命令，每个命令对应于CHttpServer（或其子类）的一个成员函数，客户端
可以在URL中指定命令名及其参数。在VC++ 6.0中是通过parse map来实现这种对应的。
Parse map类似MFC中的Windows消息分发机制，通过使用VC提供的DECLARE_PARSE_MAP、
BEGIN_PARSE_MAP、ON_PARSE_COMMAND、ON_PARSE_COMMAND_PARAMS、DEFAULT_PARSE_COMMAND、
END_PARSE_MAP等宏，可以实现对不同的命令的处理。每个CHttpServer中只能建立一个parse
map，当客户端给ISA发来命令的时候，parse map可以分析HTTP请求中的命令名及其参数，将该
命令与相应的成员函数关联起来，即由该成员函数处理该命令。以MSDN中的例子程序pinball为
例，该例中有下面这样一个表单：
<form method=get action="pinball.dll?">
<input type="hidden" name="MfcISAPICommand" VALUE="GetImage">
<input type="radio" name="Favorite" value="1" checked> Attack from Mars<br>
<input type="radio" name="Favorite" value="2"> Twilight Zone<br>
<input type="radio" name="Favorite" value="3"> The Addams Family<br>
<input type="radio" name="Favorite" value="4"> Cirqus Voltaire<br>
<input type="radio" name="Favorite" value="0"> I don´t see it here<br>
<br>
<input type="submit" value="Show Me!">
</form>
当客户端选中了上面的表单中的“Attack from Mars”这一项并点击了submit按钮后，服务器端
最终将得到如下的URL串：
http://www.abc.com/pinball.dll?MfcISAPICommand=GetImage&Favorite=1
在该URL串中，命令名是GetImage，参数Favorite的值是1，因此pinball.dll中的如下成员函数
将被调用以处理该请求，其中参数dwChoice对应URL中的参数Favorite：
void CPinballExtension::GetImage(CHttpServerContext* pCtxt, long dwChoice)；
而parse map需要按照下面的形式定义：
//CPinballExtension从CHttpServer派生而来
BEGIN_PARSE_MAP(CPinballExtension, CHttpServer)
//GetImage是CPinballExtension的成员函数，且有一个long型的参数即dwChoice
ON_PARSE_COMMAND(GetImage, CPinballExtension, ITS_I4)
//该参数在URL中的名字为Favorite
ON_PARSE_COMMAND_PARAMS("Favorite")
END_PARSE_MAP(CPinballExtension)
而对于ISAPI Filter，
上一页 [1] [2] [3] 下一页
打印文档
推荐好友 
返回顶部
增大字体 
减少字体