Re: ldap_search_s

[<tkaczma@gryf.net>]

I answered this question for myself.  It is "NO."

Tom

On Mon, 3 Apr 2000 tkaczma@gryf.net wrote:

> 
> Thanks, this makes more sense.  Can I expect the pointer to have it's
> original value after the search function is called if the search yields no
> results?
> 
> Tom
> 
> On Sat, 1 Apr 2000, Randy Kunkee wrote:
> 
> > > 
> > > Why does ldap_search_s take LDAPMessage ** as one of the arguments?
> > > 
> > > >From what I see only one LDAPMessage is ever returned.  It a bit confusing
> > > as LDAPMessage implies that it is a linked list.  Can someone explain to
> > > me why a doble pointer is necessary?
> > > 
> > > Thanks;
> > > Tom
> > > 
> > > 
> > 
> > The return value of ldap_search_s is LDAP_SUCCESS, or an error code.
> > The LDAP client library allocates memory, needs to return a pointer
> > to that message.  Since the status of the search is being returned
> > by the function, the pointer to result message structure must be
> > returned some other way.  Since what is being returned is an LDAPMessage *,
> > a pointer to that kind of memory is an LDAPMessage **.
> > 
> > By the way, you must free this when you are finished with it using
> > ldap_msgfree.
> > 
> > Example of usage would be:
> > 
> >    int resCode;
> >    LDAPMessage *ldapResultMessage; /* will point to the result */
> >    .
> >    .
> >    resCode = ldap_search_s(.... , &ldapResultMessage);
> >    if (resCode == LDAP_SUCCESS) {
> > 	.
> > 	.
> > 	ldap_msgfree(ldapResultMessage);
> >    } else {
> > 	/* print error */
> >    }
> > 
> > 
> > Regards,
> > Randy
> > 
>