# ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

ldap_parse_result — Extract information from result

### 说明

ldap_parse_result ( resource `$link` , resource `$result` , int `&$errcode` [, string `&$matcheddn` [, string `&$errmsg` [, array `&$referrals` [, array `&$serverctrls` ]]]] ) : bool

Parses an LDAP search result.

### 参数

`link`

  An LDAP link identifier, returned by ldap_connect().

`result_identifier`

  An LDAP result resource, returned by ldap_list() or ldap_search().

`errcode`

  A reference to a variable that will be set to the LDAP error code in the result, or 0 if no error occurred.

`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`.

`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.

`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.

`serverctrls`

  An array of LDAP Controls which have been sent with the response.

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
7.3 | Support for `serverctrls` added

### 范例

Example #1 ldap_parse_result() 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
    }
    ?>