Extrai informação de resultado

# ldap_parse_result

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

ldap_parse_result — Extrai informação de resultado

### Descrição

function ldap_parse_result(
LDAP\Connection `$ldap`,
LDAP\Result `$result`,
int `&$error_code`,
string `&$matched_dn` = `null`,
string `&$error_message` = `null`,
array `&$referrals` = `null`,
array `&$controls` = `null`
): bool

Interpreta um resultado de pesquisa LDAP.

### Parâmetros

`ldap`

  Uma instância de LDAP\Connection, retornada por ldap_connect().

`result`

  Uma instância de LDAP\Result, retornada por ldap_list() ou ldap_search().

`error_code`

  Uma referência a uma variável que será definida para o código de erro LDAP no resultado, ou `0` se não houve erro.

`matched_dn`

  Uma referência a uma variável que será definida para um DN correspondente se algum foi reconhecido na requisição, caso contrário será definido para `null`.

`error_message`

  Uma referência a uma variável que será definida para a mensagem de erro LDAP no resultado, ou uma string vazia se não houve erro.

`referrals`

  Uma referência a uma variável que será definida para um array definido para todas as strings referenciadas no resultado, ou um array vazio se nenhuma referência foi retornada.

`controls`

  Um array de Controles LDAP que foram enviados com a resposta.

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `ldap` agora espera uma instância de LDAP\Connection; anteriormente, um resource `ldap link` válido era esperado.
8.1.0 | O parâmetro `result` agora espera uma instância de LDAP\Result; anteriormente, um resource `ldap result` válido era esperado.
7.3.0 | Adicionado suporte para `controls`.

### Exemplos

Exemplo #1 Exemplo de ldap_parse_result()

    <?php
    $result = ldap_search($ldap, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
    $errcode = $dn = $errmsg = $refs =  null;
    if (ldap_parse_result($ldap, $result, $errcode, $dn, $errmsg, $refs)) {
        // faz alguma coisa com $errcode, $dn, $errmsg e $refs
    }
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open