南大通用GBase XDM（单机/分片集群）数据库查询

GBase XDM（单机/分片集群）数据库查询，返回请求的每一个匹配记录的属性集。 下面是三个相关函数：

struct timeval {

 long tv_sec;

 long tv_usec;

 };

 int ldap_search(

 LDAP *ld,

 char *base,

int scope,

 char *filter,

 char *attrs[],

 int attrsonly

 );

 int ldap_search_s(

 LDAP *ld,

 char *base,

 int scope,

 char *filter,

 char *attrs[],

 int attrsonly,

 LDAPMessage **res

 );

 int ldap_search_st(

 LDAP *ld,

 char *base,

 int scope,

 char *filter,

 char *attrs[],

 int attrsonly,

 struct timeval *timeout,

 LDAPMessage **res

 );

参数解释：

ld：连接句柄

base：开始搜索的 dn 记录

scope ： 常 量 LDAP_SCOPE_BASE ， LDAP_SCOPE_ONELEVEL ，

LDAP_SCOPE_SUBTREE 之一，表示搜寻范围。

filter：RFC 1558 定义的字符串，表示搜索条件。

attr：指明匹配记录的哪些属性将要返回的 NULL 结尾的字符串，传 NULL

串将返回所有可用的属性。

attronly：boolean 值，为 0 时指明返回属性的类型和属性值，非 0 值

只返回所需类型。

timeout：在调用 ldap_search_st()时，定义本地查询的超时时间。

res：在同步调用时使用，作为返回结果参数，包含查询调用完成的结

果。

ld 连接句柄的三个字段控制查询如何执行。它们是：

ld_sizelimit：限制查询返回的记录数量，0 代表无限制。

ld_timelimit：限制查询时间，以秒为单位，0 代表无限制。

ld_deref：常量 LDAP_DEREF_NEVER，LDAP_DEREF_SEARCHING，

LDAP_DEREF_FINDING，LDAP_DEREF_ALWAYS 之一。描述了在查询过程中如何处理别名。LDAP_DEREF_SEARCHING 值意为在查询中别名被解除，但不会在定位于查询的基对象时解除引用。LDAP_DEREF_FINGINFG 意为别名在定位基对象但不是在查询过程中解除引用。