Pointer to the first continuation reference. The pointer returned from
ldap_first_reference() should be supplied on a subsequent call
to ldap_next_reference() to get the next
continuation reference.
NULL
when no more continuation references exist in the result set to be
returned.
Error Conditions
If ldap_first_reference() is not successful,
ld_errno will be set to indicate the error. See
LDAP Client API Error Conditions for possible LDAP
error code values. Use ldap_get_errno()
function to retrieve the error information.
Error Messages
The following message may be sent from this function.
Message ID
Error Message Text
CPF3CF2 E
Error(s) occurred during running of
ldap_first_reference API.