IBM Sync Client C-API V8.1 与 V7.2 之间的比较

本节总结版本 8.1 中对 IBM Sync Client C-API 所做的主要更改：

现在有三个句柄可用：服务、配置和引擎。（如果不想执行同步，则不必打开同步引擎句柄。）
IBM Sync Client C-API V8.1 中的首选项不是持久的，已除去了某些首选项，这些首选项实际上是很重要的信息。例如，旧的 isyncSetPref 函数中的主机名、端口、用户名和密码现在是 iscOpenService 函数中打开服务句柄所必需的参数。
同步方式现在对应用程序是隐式的，当调用同步时同步方式参数不再是必需的。
同步侦听器的接口现在是基于事件的。现在将包含事件信息的事件结构传送到应用程序。
预订集的同步状态（来自其上次同步）是持久的，可在以后查询。
已除去缺省侦听器。当需要事件的缺省操作时，应用程序只返回 ISCRTNCB_Default 代码。
DB2e Everyplace 现在支持数据加密来保护包含敏感数据的表。当开发同步客户机应用程序来使加密表同步时，可以从同步引擎实现（在侦听器中）查询来获取 DB2 Everyplace 用户名和密码。
现在通过侦听器将拒绝的记录（包括具有冲突和非法操作的记录）传送到应用程序。
现在由应用程序管理日志文件（LOGDB-ISYNC）。即版本 8.1 同步引擎不再像在版本 7.2.1 中一样以本机语言生成日志文件（LOGDB-ISYN）。相反，为了服务目的，同步引擎将生成跟踪文件（TRACE-ISYN），该文件只有英语版。
IBM Sync Client 引擎将所有文件（包括配置、跟踪文件、数据和首选项（如果适用））存储在一个目录中：
- 在 Windows CE^(R) 操作系统上：\（根目录）
- 在 EPOC 操作系统上：C:\Systems\Data\ISync\
- 在 Palm 操作系统上：主存储器
- 在其它操作系统上：当前目录
通过 API 包装器（isynce 库），IBM Sync Client API V7.2.1 的功能仍然受支持，该包装器将处理 API 的向下兼容性。API 包装器也像在版本 7.2.1 中一样在同一目录中以本机语言生成日志文件（LOGDB-ISYN），即：
- 在 Windows CE^(R) 操作系统上：\Progran Files\ISync\
- 在 EPOC 操作系统上：C:\Systems\Apps\ISync\
- 在 Palm 操作系统上：主存储器
- 在其它操作系统上：当前目录
另外，ISYNCOPTION_SkipConfig 和 ISYNCOPTION_UseAppSignature 选项将不使用 isyncGo 和 isyncSetSyncMoe 函数。
注意:
如果选择使用 IBM Sync Client API V8.1，则需要安装 API 包装器（isynce）库。

表 114 列示 IBM Sync Client C-API V8.1 和 IBM Sync Client V7.2 中函数之间的主要差别。

表 114. IBM Sync Client C-API V8.1 和 V7.2 比较

版本 8.1	版本 7.2	注释
`iscGetVersion`	`isyncGetVersion`	`iscGetVersion` 中不需要句柄。
`iscServiceOpen` `iscConfigOpeniscEngineOpen`	`isyncOpen`	需要打开三个句柄。在 `iscServiceOpen` 中指定主机、端口、用户名和密码，且它们不是持久的。
`iscServiceClose` `iscConfigClose` `iscEngineClose`	`isyncClose`	需要关闭三个句柄。
`iscEngineSetListener`	`isyncSetListener`	已更改了侦听器原型和接口。
（无）	`isyncDefaultListener`	不再有外部缺省侦听器。对于缺省事件处理，返回 ISCRTNCB_Default 代码。
`iscEngineSetPref` `iscEngineGetPref`	`isyncSetPref` `isyncGetPref`	仅需要两个首选项（跟踪和超时）。这些首选项不是持久的。
`iscEngineSync` `iscEngineSyncConfig`	`isyncGo`	不再需要同步方式。仅可以使用 `iscEngineSyncConfig` 更新配置。
`iscConfigEnableSubsSet` `iscConfigDisableSubsSet` `iscConfigResetSubsSet`	`isyncSetSyncMode`	不再有常规同步方式设置。可以通过 `iscConfigDisableSubsSet` 跳过（禁用）预订集的同步。
`iscConfigOpenCursor` `iscConfigCloseCursor` `iscConfigGetNextSubsSet` `iscConfigSubsSetIsEnabled` `iscConfigSubsSetIsReset`	`isyncGetFirstApp` `isyncGetNextApp`	在迭代预订集之前打开游标。需要预订集标识才能查询预订集。
`iscEngineGetInfo` `iscConfigPurge` `iscConfigGetSubsSetStatus`		版本 8.1 中的新的 C-API。

相关概念

样本 Sync Client C/C++ 应用程序

相关任务

使用 C/C++ 开发 DB2 Everyplace Sync Client 应用程序

相关参考