GBase8d_C_API_04_LDAP C API的使用方式

GBase8d_C_API_04_LDAP C API的使用方式

通过上面的介绍，用户一定想知道如何使用GBase 8d C API编写客户端程序，实现对目录服务器的基本操作，目录服务器的基本操作共有9个

1. 绑定
2. 解绑定
3. 添加
4. 删除
5. 修改
6. 更改RDN
7. 查询
8. 比较
9. 放弃

应用程序通常按以下四个步骤使用GBase 8d C API，完成上面的操作。

1. 打开一个到LDAP Server的连接，ldap_init()返回连接句柄，允许多个连接同时打开。
2. 绑定：使用ldap_simple_bind()及其他相关函数进行绑定。
3. 执行ldap操作获取结果。例如：查询操作ldap_search()及相关函数返回的结果可以由ldap_result2error(),ldap_first_entry(),ldap_next_entry()解析。
4. 解绑定并关闭连接。由ldap_unbind()调用实现。

操作能够同步或异步地执行。

下面解释一下同步和异步操作：

1. 同步执行模式：客户应用请求发给服务器之后，将等待服务器返回所有结果，才继续执行。例如查询操作，客户端上的应用程序在向服务器发出查询操作的指令后，将一直等待服务器将查询结果返回客户端后，才继续进行下一步操作。
2. 异步执行模式：是指语句在异步执行模式下，各语句执行结束的顺序与语句执行开始的顺序并不一定相同。例如查询操作，客户端上的应用程序在向服务器发出了查询操作的指令后，将立刻执行查询语句的下一条语句，而不需要等到服务器将查询结果返回客户端后，才继续进行下一步操作。

在LDAP操作中也同样存在以上两种执行模式，在GBase 8d C API中，同步调用以_s结尾，所以同步查询的函数为ldap_search_s()。所有同步程序返回一个代表操作结果的指示符。(例如：常量LDAP_SUCCESS或其他错误码)。异步程序返回操作初始化的消息ID。此ID可以被随后的ldap_result()调用取得操作结果(结果集)。一个异步操作可以被ldap_abandon()函数取消。

结果和错误返回到一个非透明的结构LDAPMessage中。程序提供解析此结构、进入条目和返回的属性等功能。程序同样提供错误解释工作。下一节详细描述这些程序例程。

在下面的各章节中我们以LDAP的9大基本操作，逐步讲解使用GBase 8d C API的编写客户端程序的过程。除了abandon操作以外的其它操作又分同步和异步两种。在每个sample中都有绑定和解绑定两种操作,所以我们只在第一个sample中讲解绑定和解绑定。