[Open]LDAP C API's rebind_proc differences: LDAPv2 vs. LDAPv3

[Konstantin Chuguev <Konstantin.Chuguev@dante.org.uk>]

Hi,

I looked through mailing lists and in Google but didn't find anything
about it:
Netscape SDK (and perhaps OpenLDAP-1.2) have the following definintion
of the rebind_proc:
int rebind_proc( LDAP *ld, char **dnp, char **pwp, int *authmethodp, int
freeit [, void *arg] );

In OpenLDAPv2, the callback prototype is different:

typedef int (LDAP_REBIND_PROC) LDAP_P(( LDAP *ld, LDAP_CONST char *url,
int request, ber_int_t msgid ));

What is the meaning of the callback parameters and the result? I need to
fix a piece of code to use the new API...
Unfortunately, the ldap_set_rebind_proc manual page still describes the
old prototype.
I used to have a link to an LDAP C API Internet Draft, but have lost it.

Is the new prototype OpenLDAP-specific?

Thanks,
    Konstantin.

--
          * *        Konstantin Chuguev - Application Engineer
       *      *              Francis House, 112 Hills Road
     *                       Cambridge CB2 1PQ, United Kingdom
 D  A  N  T  E       WWW:    http://www.dante.net