Microsoft Agent的COM接口编程

Microsoft Agent的COM接口编程(3) SysFreeString(bszSpeak); //释放字符串所占内存

4．释放对象

程序在退出之前需要把创建的Agent对象释放：

if (pCharacter) {
pCharacter－>Release(); //释放IAgentCharacter接口
pAgent－>Unload(lCharID); //卸载动画人物数据
}
pAgent－>Release(); //释放Agent对象
VariantClear(＆vPath); //清除OLE变量

进一步的编程要点

前面介绍的是调用Microsoft Agent服务器最基本的一些步骤，为了完成比较实际的任务，客户程序还应根据自己的情况考虑下面的一些编程要点。

1．检查Agent Server的版本

OLE要求组件或对象具有向后兼容性，高版本对象支持低版本对象的所有接口和属性，这样可以很方便地进行组件升级。客户程序通常应检查对象的版本，只有系统中安装的对象的版本号高于或等于所期望的版本号时才能调用对象。下面的IsValidAgentVersion()函数检查Microsoft Agent的版本号，并将它与定义在AgtSvr.h文件中的版本号相比较：

BOOL IsValidAgentVersion(IAgent ＊pAgent) {
IDispatch ＊pdAgent = NULL;
ITypeInfo ＊pTypeInfo = NULL;
ITypeLib ＊pTypeLib = NULL;
TLIBATTR ＊pTypeLibAttr = NULL;
BOOL bValid = FALSE;
UINT uiIndex;
pAgent－>QueryInterface(IID—IDispatch, (LPVOID ＊)＆pdAgent);
pdAgent－>GetTypeInfo(0, 0, ＆pTypeInfo)； //取得类型信息
pTypeInfo－>GetContainingTypeLib(＆pTypeLib, ＆uiIndex);//取得类型库
pTypeLib－>GetLibAttr(＆pTypeLibAttr); //取得类型库中的属性
if ((pTypeLibAttr－>wMajorVerNum > AGENT—VERSION—MAJOR) ¦¦((pTypeLibAttr－>wMajorVerNum == AGENT—VERSION—MAJOR) ＆＆(pTypeLibAttr－>wMinorVerNum >= AGENT—VERSION—MINOR)))
bValid = TRUE; //期望的版本号定义在AgtSvr.h文件中
if (pTypeLib) {
if (pTypeLibAttr) pTypeLib－>ReleaseTLibAttr(pTypeLibAttr);
pTypeLib－>Release(); }
if (pTypeInfo) pTypeInfo－>Release();
if (pdAgent) pdAgent－>Release();
return bValid;}

2．实现IAgentNotifySink接口

为了能够处理用户的输入，了解Agent对象的状态，客户程序应实现IAgentNotifySink接口来接收Agent对象的事件。IAgentNotifySink的声明和缺省实现可以在Platform SDK或Internet Clinet SDK中的Notify.h和Notify.cpp中找到，客户程序应根据需要修改某些事件的处理函数
。下面的代码向Agent对象注册IAgentNotifySink接口，其中AgentNotifySink是从IAgentNotifySink继承而来：

pSink = new AgentNotifySink;
pSink－>AddRef(); //增加引用计数
hRes = pAgent－>Register((IUnknown ＊)pSink, ＆lNotifySinkID);//进行注册
...
if (pSink) {
pAgent－>Unregister(lNotifySinkID); //注销IAgentNotifySink接口