4.1 Search

Function: number search (string basedn, string filter, ...)

Searches for objects matching filter in DN basedn and retrieves attributes specified by the variable arguments. If basedn is an empty string, the base setting from the ldap.conf file is used.

On success, returns a non-negative result set descriptor.

On error, it raises the e_failure exception (see Built-in Exceptions in Mailfromd Manual) with an appropriate explanatory message.

Function: void search_result_free (number rd)

Reclaims the memory and other resources allocated for the result set rd. Use this function when the result set is no longer needed.

If rd does not refer to a valid result set, the function reports the e_range exception.