LDAP_PARSE_RESULT(3) 1 LDAP_PARSE_RESULT(3)
ldap_parse_result - Extract information from result
SYNOPSIS
bool ldap_parse_result (resource $link, resource $result, int &$errcode, [string &$matcheddn], [string &$errmsg], [array &$refer-
rals])
DESCRIPTION
Parses an LDAP search result.
PARAMETERS
o $link
- An LDAP link identifier, returned by ldap_connect(3).
o $result_identifier
- An LDAP result resource, returned by ldap_list(3) or ldap_search(3).
o $errcode
- A reference to a variable that will be set to the LDAP error code in the result, or 0 if no error occurred.
o $matcheddn
- A reference to a variable that will be set to a matched DN if one was recognised within the request, otherwise it will be set to
NULL.
o $errmsg
- A reference to a variable that will be set to the LDAP error message in the result, or an empty string if no error occurred.
o $referrals
- A reference to a variable that will be set to an array set to all of the referral strings in the result, or an empty array if no
referrals were returned.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
ldap_parse_result(3) example
<?php
$result = ldap_search($link, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
$errcode = $dn = $errmsg = $refs = null;
if (ldap_parse_result($link, $result, $errcode, $dn, $errmsg, $refs)) {
// do something with $errcode, $dn, $errmsg and $refs
}
?>
PHP Documentation Group LDAP_PARSE_RESULT(3)