在学习的过程中，我发现下面两篇文章很有指导意义，代码基本是从第一篇文章拷贝而来。
第一篇文章先写了一个DLL，这个DLL实现了求两个数之和的函数。接着实现了一个简单的ATL对象，通过该ATL对象调用DLL中实现的函数，最后在Javascript中调用该ATL对象相应的方法以求两个数之和。
我想着扩展一下这个例子，在DLL中实现了一个函数以获取笔记本电脑电池电量的剩余时间，关于电池的信息，Windows提供了一个很方便的API-GetSystemPowerStatus供开发者使用，该API返回一个结构体如下:
typedef struct _SYSTEM_POWER_STATUS {
BYTE ACLineStatus;
BYTE BatteryFlag;
BYTE BatteryLifePercent;
BYTE Reserved1;
DWORD BatteryLifeTime;
DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;
通过MSDN可以查到结构体各字段的意义，这个例子中只用到了第五个字段用以获取电池的可持续时间（以秒为单位，当笔记本电脑直接接着交流电时会返回-1），当然也可以一次性返回整个结构体，不过这需要定义比较复杂的IDL类型，我想着返回简单int型比较简单，所以也就返回这一个值了。
首先新建一个DLL工程，就取名为CalcImpl工程，然后新建一个dll.h和dll.cpp文件，在dll.h写入以下代码：
#ifndef _DLL_H_
#define _DLL_H_
#if defined DLL_EXPORT
#define DECLDIR _declspec(dllexport)
#else
#define DECLDIR _declspec(dllimport)
#endif
extern "C"
{
DECLDIR int Add(int a, int b);
DECLDIR int ShowBatteryLifeTime(void);
}
#endif
在dll.cpp写入以下代码：
#include <windows.h>
#define DLL_EXPORT
#include "dll.h"
extern "C"
{
DECLDIR int Add(int a, int b)
{
return (a + b);
}
DECLDIR int ShowBatteryLifeTime(void)
{
SYSTEM_POWER_STATUS SystemPowerStatus;
GetSystemPowerStatus(&SystemPowerStatus);
int BatteryLifeTime = SystemPowerStatus.BatteryLifeTime;
return BatteryLifeTime;
}
}
Build会生成CalcImpl.lib和CalcImpl.dll文件。接着新建一个ATL Project，取名为CalcCtrl，完成之后会自动生成很多文件。接着为工程添加一个类，在对话框中选择"ATL Simple Object"，在接下来的对话框中输入"MyTest"，在Options中勾上"Support"多选框中的"Connection points"和"IObjectWithSite(IE object support)"，点finish之后工程会生成MyTest对象，自动生成MyTest.h和MyTest.cpp等文件。然后选择类视图，右击"IMyTest"项，然后选择"Add"->"Add Method"，在弹出的对话框中的"Method name"处填入"GetBatteryLifeTime"，这个方法是最后供Javascript使用的。我发现这儿有一个奇怪的事情，在为方法名选择参数时，out和retval多选框始终都是灰色的，而in确实可以选上的。因为根据用户的选择会生成相关的代码，此处如果不能设置好返回类型，那么就必须手动修改一些文件了。CalcCtrl.idl文件中有接口的定义，接口的实现则放在MyTest.cpp中。编译CalcCtrl.idl文件居然不会对MyTest.h和MyTest.cpp做相应的修改，有点不方便。"GetBatteryLifeTime"只有一个int型的返回值，手动修改CalcCtrl.idl中该接口的声明如下：
GetBatteryLifeTime( [out, retval]INT* out);
对MyTest.h和MyTest.cpp也做相应的处理，因为两个文件中都是C++的代码，所以去掉[out, retval]便可。在MyTest.h头文件中添加以下两句：
#include "../CalcImpl/dll.h" //用于包含相关函数声明
#pragma comment(lib, "CalcImpl.lib") //隐式使用CalcImpl.dll所需要的
第一篇文章中直接通过LoadLibrary/GetProcAddress/FreeLibrary来使用CalcImpl.dll中的函数，这样太麻烦了，即要声明函数指针类型，又要注意释放句柄，不如通过隐式调用来使用CalcImpl.dll中的函数。在MyTest.cpp文件的CMyTest::GetBatteryLifeTime函数写入以下代码：
STDMETHODIMP CMyTest::GetBatteryLifeTime(INT* out)
{
//只是简单地调用CalcImpl.dll中的函数
*out = ShowBatteryLifeTime();
return S_OK;
}
build CalcCtrl工程将生成CalcCtrl.dll，不过会有如下的错误提示：
Project : error PRJ0050: Failed to register output. Please try enabling Per-user Redirection or register the component from a command prompt with elevated permissions.
VS似乎在尝试注册该组件，权限不够所以失败了，在一个普通的命令窗口使用regsvr32注册组件也会失败，如果使用管理员身份打开命令窗口就能成功注册该组件了。上面这个错误没有什么影响，因为注册是要交给浏览器自动完成的，这儿生成CalcCtrl.dll就好了。
当网页中嵌入ActiveX对象时，浏览器会判断该对象是否已经存在，如果不存在将提示下载相关的资源，下载完成之后如何处置，这就需要一个inf文件来说明了。因此创建一个setup.inf文件，写入以下内容：
[version]
; version signature (same for both NT and Win95) do not remove
signature="$CHICAGO$"
AdvancedINF=2.0
[Add.Code]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[install.files]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[CalcCtrl.dll]
clsid={ A83904E6-3288-431C-8213-8874E228990E}
file-win32-x86=thiscab
FileVersion=1,0,0,1
DestDir=11
RegisterServer=yes
[CalcImpl.dll]
file-win32-x86=thiscab
DestDir=11
FileVersion=1,0,0,1
RegisterServer=yes
[setup.inf]
file=thiscab
[RegisterFiles]
%11%\CalcCtrl.dll
; end of INF file
"DestDir=11"表示将DLL下载到系统目录下（WINDOWS/SYSTEM32）。CalcImpl.dll、CalcCtrl.dll和setup.inf三件东西都准备好了之后就要开始打包了。打开一个cmd窗口，输入"iexpress"，根据向导一步步做，最后生成一个calc.CAB文件。接着写一个测试网页，内容如下：
<HTML>
<HEAD>
<TITLE>Test ActiveX</TITLE>
<OBJECT ID="CalcCtrl" NAME="CalcCtrl"
CODEBASE="calc.CAB#version=1,0,0,1"
CLASSID="clsid: A83904E6-3288-431C-8213-8874E228990E">
</OBJECT>
<script language="javascript">
function doTest()
{
var leftTime = CalcCtrl.GetBatteryLifeTime();
if(leftTime == -1)
{
alert("unknown");
}
else
{
var hours;
//Javascript的'/'运算符并不会取整
hours = leftTime / 3600;
alert(hours + "hours");
}
}
</script>
</HEAD>
<BODY>
<input type="button" value="Get left time" id="btnOK" onclick="doTest();"></input>
</BODY>
</HTML>
上面用到的clsid可以在工程中的MyTest.rgs文件找到，这个文件中包含一些要写入注册表的信息，setup.inf中的那个clsid随便填似乎都可以，这个页面中的clsid就必须填正确了。使用IE浏览器打开该页面之后，会提示有不安全的内容，点击"允许阻止的内容"之后，会接连弹出两个对话框（这里是在单机环境进行测试的，在真实的网路环境下，可以还要配置下IE浏览器，让其运行未验证的ActiveX对象或者添加信任域），然后就可以在"WINDOWS/SYSTEM32"目录下发现CalcImpl.dll，CalcCtrl.dll这两个文件了。当笔记本接着交流电时，弹出的对话框将将提示"unknown"，只有拔掉电源，不断刷新页面，过一会儿将显示电池的剩余使用时间。
每次使用时都会弹出如下的对话框，很烦人。
typedef struct _SYSTEM_POWER_STATUS {
BYTE ACLineStatus;
BYTE BatteryFlag;
BYTE BatteryLifePercent;
BYTE Reserved1;
DWORD BatteryLifeTime;
DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;
通过MSDN可以查到结构体各字段的意义，这个例子中只用到了第五个字段用以获取电池的可持续时间（以秒为单位，当笔记本电脑直接接着交流电时会返回-1），当然也可以一次性返回整个结构体，不过这需要定义比较复杂的IDL类型，我想着返回简单int型比较简单，所以也就返回这一个值了。
首先新建一个DLL工程，就取名为CalcImpl工程，然后新建一个dll.h和dll.cpp文件，在dll.h写入以下代码：
#ifndef _DLL_H_
#define _DLL_H_
#if defined DLL_EXPORT
#define DECLDIR _declspec(dllexport)
#else
#define DECLDIR _declspec(dllimport)
#endif
extern "C"
{
DECLDIR int Add(int a, int b);
DECLDIR int ShowBatteryLifeTime(void);
}
#endif
在dll.cpp写入以下代码：
#include <windows.h>
#define DLL_EXPORT
#include "dll.h"
extern "C"
{
DECLDIR int Add(int a, int b)
{
return (a + b);
}
DECLDIR int ShowBatteryLifeTime(void)
{
SYSTEM_POWER_STATUS SystemPowerStatus;
GetSystemPowerStatus(&SystemPowerStatus);
int BatteryLifeTime = SystemPowerStatus.BatteryLifeTime;
return BatteryLifeTime;
}
}
Build会生成CalcImpl.lib和CalcImpl.dll文件。接着新建一个ATL Project，取名为CalcCtrl，完成之后会自动生成很多文件。接着为工程添加一个类，在对话框中选择"ATL Simple Object"，在接下来的对话框中输入"MyTest"，在Options中勾上"Support"多选框中的"Connection points"和"IObjectWithSite(IE object support)"，点finish之后工程会生成MyTest对象，自动生成MyTest.h和MyTest.cpp等文件。然后选择类视图，右击"IMyTest"项，然后选择"Add"->"Add Method"，在弹出的对话框中的"Method name"处填入"GetBatteryLifeTime"，这个方法是最后供Javascript使用的。我发现这儿有一个奇怪的事情，在为方法名选择参数时，out和retval多选框始终都是灰色的，而in确实可以选上的。因为根据用户的选择会生成相关的代码，此处如果不能设置好返回类型，那么就必须手动修改一些文件了。CalcCtrl.idl文件中有接口的定义，接口的实现则放在MyTest.cpp中。编译CalcCtrl.idl文件居然不会对MyTest.h和MyTest.cpp做相应的修改，有点不方便。"GetBatteryLifeTime"只有一个int型的返回值，手动修改CalcCtrl.idl中该接口的声明如下：
GetBatteryLifeTime( [out, retval]INT* out);
对MyTest.h和MyTest.cpp也做相应的处理，因为两个文件中都是C++的代码，所以去掉[out, retval]便可。在MyTest.h头文件中添加以下两句：
#include "../CalcImpl/dll.h" //用于包含相关函数声明
#pragma comment(lib, "CalcImpl.lib") //隐式使用CalcImpl.dll所需要的
第一篇文章中直接通过LoadLibrary/GetProcAddress/FreeLibrary来使用CalcImpl.dll中的函数，这样太麻烦了，即要声明函数指针类型，又要注意释放句柄，不如通过隐式调用来使用CalcImpl.dll中的函数。在MyTest.cpp文件的CMyTest::GetBatteryLifeTime函数写入以下代码：
STDMETHODIMP CMyTest::GetBatteryLifeTime(INT* out)
{
//只是简单地调用CalcImpl.dll中的函数
*out = ShowBatteryLifeTime();
return S_OK;
}
build CalcCtrl工程将生成CalcCtrl.dll，不过会有如下的错误提示：
Project : error PRJ0050: Failed to register output. Please try enabling Per-user Redirection or register the component from a command prompt with elevated permissions.
VS似乎在尝试注册该组件，权限不够所以失败了，在一个普通的命令窗口使用regsvr32注册组件也会失败，如果使用管理员身份打开命令窗口就能成功注册该组件了。上面这个错误没有什么影响，因为注册是要交给浏览器自动完成的，这儿生成CalcCtrl.dll就好了。
当网页中嵌入ActiveX对象时，浏览器会判断该对象是否已经存在，如果不存在将提示下载相关的资源，下载完成之后如何处置，这就需要一个inf文件来说明了。因此创建一个setup.inf文件，写入以下内容：
[version]
; version signature (same for both NT and Win95) do not remove
signature="$CHICAGO$"
AdvancedINF=2.0
[Add.Code]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[install.files]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[CalcCtrl.dll]
clsid={ A83904E6-3288-431C-8213-8874E228990E}
file-win32-x86=thiscab
FileVersion=1,0,0,1
DestDir=11
RegisterServer=yes
[CalcImpl.dll]
file-win32-x86=thiscab
DestDir=11
FileVersion=1,0,0,1
RegisterServer=yes
[setup.inf]
file=thiscab
[RegisterFiles]
%11%\CalcCtrl.dll
; end of INF file
"DestDir=11"表示将DLL下载到系统目录下（WINDOWS/SYSTEM32）。CalcImpl.dll、CalcCtrl.dll和setup.inf三件东西都准备好了之后就要开始打包了。打开一个cmd窗口，输入"iexpress"，根据向导一步步做，最后生成一个calc.CAB文件。接着写一个测试网页，内容如下：
<HTML>
<HEAD>
<TITLE>Test ActiveX</TITLE>
<OBJECT ID="CalcCtrl" NAME="CalcCtrl"
CODEBASE="calc.CAB#version=1,0,0,1"
CLASSID="clsid: A83904E6-3288-431C-8213-8874E228990E">
</OBJECT>
<script language="javascript">
function doTest()
{
var leftTime = CalcCtrl.GetBatteryLifeTime();
if(leftTime == -1)
{
alert("unknown");
}
else
{
var hours;
//Javascript的'/'运算符并不会取整
hours = leftTime / 3600;
alert(hours + "hours");
}
}
</script>
</HEAD>
<BODY>
<input type="button" value="Get left time" id="btnOK" onclick="doTest();"></input>
</BODY>
</HTML>
上面用到的clsid可以在工程中的MyTest.rgs文件找到，这个文件中包含一些要写入注册表的信息，setup.inf中的那个clsid随便填似乎都可以，这个页面中的clsid就必须填正确了。使用IE浏览器打开该页面之后，会提示有不安全的内容，点击"允许阻止的内容"之后，会接连弹出两个对话框（这里是在单机环境进行测试的，在真实的网路环境下，可以还要配置下IE浏览器，让其运行未验证的ActiveX对象或者添加信任域），然后就可以在"WINDOWS/SYSTEM32"目录下发现CalcImpl.dll，CalcCtrl.dll这两个文件了。当笔记本接着交流电时，弹出的对话框将将提示"unknown"，只有拔掉电源，不断刷新页面，过一会儿将显示电池的剩余使用时间。
每次使用时都会弹出如下的对话框，很烦人。
可以参看第二篇文章，将类MyTest从IObjectSafetyImpl派生可以解决这个问题。我还发现另外一个问题，如果使用下面的代码调用ActiveX对象：
MyTest = new ActiveXObject( "CalcCtrl.MyTest");
var sum = MyTest.GetBatteryLifeTime();
浏览器并不会自动下载calc.CAB文件，所以页面运行将出错。但是如果组件已经被安装了，使用这种方法却又能正常工作。