função ldap_next_reference (winldap.h)
A função ldap_next_reference recupera uma referência de uma cadeia de resultados de pesquisa.
Sintaxe
WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
[in] LDAP *ld,
[in] LDAPMessage *entry
);
Parâmetros
[in] ld
O identificador da sessão.
[in] entry
A entrada retornada por uma chamada anterior para ldap_first_reference ou ldap_next_reference.
Valor retornado
Se a pesquisa retornou resultados válidos, essa função retornará um ponteiro para a próxima entrada de resultado no conjunto de resultados. Se não houver mais entradas ou referências no conjunto de resultados, ele retornará NULL. Esse é o único retorno de erro; o parâmetro de erro de sessão na estrutura de dados LDAP é limpo para 0 em ambos os casos.
Comentários
Use ldap_next_reference em conjunto com ldap_first_reference para percorrer e recuperar uma lista de referências de continuação de uma cadeia de resultados de pesquisa.
A função retorna indicações subordinadas (referências) retornadas em respostas de pesquisa. Uma indicação subordinada é aquela em que o servidor retornou alguns dados e a indicação foi passada para outros contextos de nomenclatura abaixo do nível atual na árvore. Para percorrer referências externas nas quais o contexto de nomenclatura não reside no servidor, use ldap_parse_result.
Você não precisa liberar explicitamente a referência retornada, pois ela é liberada quando a própria mensagem é liberada.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | winldap.h |
| Biblioteca | Wldap32.lib |
| DLL | Wldap32.dll |