【vc++精品源码栏目提醒】:网学会员为需要vc++精品源码的朋友们搜集整理了【精品】Lotus NotesDomino 的 C API 编程 - 其它资料相关资料,希望对各位网友有所帮助!
developerWorks 中国 gt Lotus gtLotus Notes/Domino 的 C API编程 级别: 初级 文 Nagendra Nyamgondalu 顾问软件工程师r IBM 2005 年 2 月 01 日 了解使用 Lotus Notes/Domino C API 进行编程的来龙去脉。
本文将解释 C API 工具箱中发现的一些重要特性,并提 供一些可以用来满足您需求的应用示例。
使用 Lotus C API for Lotus Notes/Domino 常常使人想起一把方便好用的老式瑞士军刀:一个时髦的小工具箱,包含 许多没有书面文档的(undocumented)有用部件!本文旨在重点介绍 Lotus C API for Lotus Notes/Domino 的一 些功能,帮助开发人员重新发现其无限的潜在用途。
对 Lotus Notes/Domino 有基本的了解并熟悉编程语言就足以应付 本文的内容。
C 编程语言的应用知识可以帮助您更好地理解我们讨论的一些概念。
Lotus C API toolkit 简介 可以通过访问 Toolkits amp Drivers page 下载 Lotus C API toolkit for Lotus Notes/Domino。
本文的目的是想将该工具箱 的 Lotus Notes/Domino 6.5。
在将下载的档案文件中的这些文件解压缩之后,就可以获得文档、头文件、库文件、已编译的 示例中使用的数据库。
文档中包括一个用户指导和一个参考指导,它们都是以单独 Notes 数据库的形式出现的。
您可以从文档中获得许多信息。
同时 用该工具箱完成哪些任务以及如何完成这些任务的介绍,而参考指导记录了所有可用功能。
请仔细考虑一下这些数据库中包含的 创建全文(full-text)索引很有用,这样就可以快速准确地进行查找。
头文件通常可以在 Include 文件夹中找到。
它们包含用于所有可作为该工具箱的一部分的常数、结构、宏、公共函数的定义。
API 调用在源代码中包含相应的头文件。
库文件和已编译的 OBJ 文件通常可以在不同操作系统的特定文件夹下的 Lib 文件夹 是需要链接到 API 程序的 DLL 导入库,所以 OBJ 文件是使用 NotesMain 入口点的程序或完成插件服务器任务所需的引导 章的后面部分再次回顾这些内容。
) 示例文件夹中提供了一个详尽的示例程序列表。
notedata 文件夹通常包含示例程序中用到的所有数据库。
参考指导中描绘了每 少可以被一个示例程序引用,您可以查看该参考指导,以便了解如何在实际程序中使用即将检查的函数。
在明白了我们必须做什么之后,继续研究该工具箱的最好办法就是钻研一个实际的程序。
在下一节中,我们将通过遍历两个不同 创建一个简单的程序 让我们从一个简单的程序开始:一个输出 Notes 数据目录的完全路径的程序。
首先,让程序中所需的 C 库中包含头文件: include ltstdio.hgt include ltstring.hgt 接下来,添加来自 Lotus C API for Lotus Notes/Domino 的头文件: include ltglobal.hgt include ltosfile.hgt 现在,主函数的任务是调用 NotesInitExtended 函数来初始化 Notes 运行库。
除非使用的是 NotesMain 函数而不是显式调用 NotesInitExtended 函数: int mainint argc char argv char DataDir256 STATUS error NOERROR WORD wlength if error NotesInitExtended argc argv printfquotn Unable to initialize Notes.nquot return 1 最后,我们获得数据目录并输出它。
OSGetDataDirectory 是这个程序中使用的主要 Lotus C API 函数。
顾名思义,OSG数据目录的完全路径。
NotesTerm 函数关闭了 Notes 运行库,以结束函数的运行。
只有在使用 NotesInitExtended 启必须显式调用该函数: wlength OSGetDataDirectoryDataDir if wlength gt 0 printfquotn The data directory is squot DataDir NotesTerm return 0 编译和链接接下来,我们要编译和链接刚才编写的程序。
为此,需要确保已正确地建立了使用环境。
当然,最重要的要求是安装 Lotus Notesfor Lotus Notes/Domino 的匹配版本。
此外,还需要 Microsoft Visual C 开发环境,以及随该环境一起提供的 Micros最后,我们需要设置三个环境变量: PATH 变量值应该包含 Notes 程序