função ldap_first_reference (winldap.h)
A função ldap_first_reference retorna a primeira referência de uma mensagem.
Sintaxe
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_reference(
[in] LDAP *ld,
[in] LDAPMessage *res
);
Parâmetros
[in] ld
O identificador de sessão.
[in] res
O resultado da pesquisa, conforme obtido por uma chamada para uma das rotinas de pesquisa síncronas ou ldap_result.
Retornar valor
Se a pesquisa retornar resultados válidos, essa função retornará um ponteiro para a primeira referência de resultado. Se nenhuma entrada ou referência existir no conjunto de resultados, ela 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_first_reference em conjunto com ldap_next_reference para percorrer e recuperar uma lista de referências de continuação de uma cadeia de resultados de pesquisa.
A função retorna referências 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 mensagem em si é liberada.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |