关于C语言开发ISAPI的难点与技巧

C 开发 ISAPI 的详细指南

ISAPI（Internet Server Application Programming Interface）是微软推出的一种编程接口，允许开发者编写扩展模块来扩展 IIS（Internet Information Services）服务器的功能，这些模块可以用于处理 HTTP 请求、执行自定义脚本、进行身份验证等，使用 C 语言开发 ISAPI 程序需要一定的技术背景和对 HTTP 协议的理解，以下是关于如何用 C 语言开发 ISAPI 程序的详细指南。

环境准备

在开始开发之前，确保你的开发环境中已经安装了以下工具：

Microsoft Visual Studio：推荐使用最新版本，因为它包含了开发 ISAPI 所需的所有工具和库。

IIS 服务器：你需要一个运行中的 IIS 服务器来测试和部署你的 ISAPI 程序。

创建项目

打开 Microsoft Visual Studio，创建一个新的动态链接库（DLL）项目：

1、选择“File” > “New” > “Project”。

2、选择“Dynamic-Link Library (DLL)”模板。

3、配置项目名称和位置，然后点击“Create”。

编写 ISAPI 程序

在项目中添加一个新的源文件，例如my_isapi.c，并编写以下代码：

#include <windows.h>
#include <httpext.h>
#include <stdio.h>
// ISAPI Extension Functions
static HSE_STATIC_PROC GetExtensionVersion(LPECINFO peci, LPHSE_VERSION_INFO pVer) {
    pVer->dwMiscStatus = HSE_STATUS_DEFAULT;
    pVer->dwServerComment = 0;
    pVer->dwFlags = HSE_VERSION_FLAGS_NONE;
    pVer->lpszExtensionDesc = "My ISAPI Example";
    return HSE_STATUS_SUCCESS;
}
static HSE_STATIC_PROC GetExtensionInfo(LPECINFO peci, LPHSE_INFO pInfo) {
    pInfo->lpECData = NULL;
    pInfo->dwSecurityBits = HSE_PRIVACY_LEVEL_NONE;
    pInfo->lpszMethod = "GET,HEAD,POST";
    pInfo->dwControlFlags = HSE_CONTROL_NO_CACHE;
    return HSE_STATUS_SUCCESS;
}
static HSE_STATIC_PROC HttpExtentionProc(LPEXTENSION_CONTROL_BLOCK pECB) {
    switch (pECB->dwHttpEvent) {
        case EVENT_REQUEST_START: {
            printf("Request Started
");
            break;
        }
        case EVENT_END_OF_NETWORK_STRING: {
            printf("End of Network String
");
            break;
        }
        default:
            break;
    }
    return HSE_STATUS_SUCCESS;
}
// ISAPI Export Table
static HSE_EXPORT const ISAPI_FUNCTABLE MyIsapiFunctions[] = {
    { PARSING_EVENT_START, (LPHSE_HOOK)GetExtensionVersion },
    { PARSING_EVENT_END, (LPHSE_HOOK)GetExtensionInfo },
    { HTTP_EVENT_START, (LPHSE_HOOK)HttpExtentionProc },
    { HTTP_EVENT_END, NULL }
};
extern "C" __declspec(dllexport) const ISAPI_FUNCTABLE GetExtensionFunctionPointers() {
    return &MyIsapiFunctions[0];
}

编译和生成 DLL

在 Visual Studio 中，选择“Build” > “Build Solution”来编译你的项目，如果一切正常，你将在项目的输出目录中找到生成的 DLL 文件。

注册 ISAPI DLL

将生成的 DLL 文件复制到 IIS 服务器的C:WindowsSystem32inetsrv 目录下，使用以下命令注册该 DLL：

regsvr32 my_isapi.dll

6. 配置 IIS 使用 ISAPI DLL

1、打开 IIS 管理器。

2、选择你的网站或应用程序。

3、双击“Handler Mappings”。

4、点击右侧的“Add Module Mapping”。

5、在“Request path”中输入你想要映射的路径，例如.myext。

6、在“Module”中选择“ISAPI Extensions”。

7、在“Executable”中输入你的 DLL 文件的完整路径，例如C:WindowsSystem32inetsrvmy_isapi.dll。

8、确保“Name”字段填写了适当的名称，例如MyISAPI。

9、点击“Request restrictions”，确保只勾选“Invoke handler only if request is mapped to".myext"`。

10、点击“OK”保存设置。

测试 ISAPI 程序

重启 IIS 服务器，然后访问你的网站或应用程序，尝试触发 ISAPI 程序，如果你映射的是.myext，那么访问http://yourserver/test.myext 应该会看到 ISAPI 程序的处理结果。

FAQs

Q1: 我该如何调试 ISAPI 程序？

A1: 你可以使用 Visual Studio 的远程调试功能来调试 ISAPI 程序，确保你的 ISAPI 程序在调试模式下编译，在 IIS 中配置你的网站以启用调试，在 Visual Studio 中，选择“Debug” > “Attach to Process”，选择w3wp.exe（IIS 工作进程），然后开始调试。

Q2: 我该如何处理 ISAPI 程序中的错误？

A2: ISAPI 程序中的错误处理通常涉及返回适当的 HTTP 状态码和错误消息，你可以在 ISAPI 函数中使用SetLastError 函数设置错误代码，并返回相应的 HSE_STATUS 值，你还可以在日志文件中记录错误信息，以便后续分析。