função ldap_parse_result (winldap.h)
A função ldap_parse_result analisa as respostas do servidor e retorna os campos apropriados.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_parse_result(
[in] LDAP *Connection,
[in] LDAPMessage *ResultMessage,
[out, optional] ULONG *ReturnCode,
[out, optional] PSTR *MatchedDNs,
[out, optional] PSTR *ErrorMessage,
[out, optional] PSTR **Referrals,
[out, optional] PLDAPControlA **ServerControls,
[in] BOOLEAN Freeit
);
Parâmetros
[in] Connection
O identificador de sessão.
[in] ResultMessage
O resultado de uma operação LDAP, conforme retornado por uma das chamadas de operação síncronas ou por ldap_result para uma operação assíncrona.
[out, optional] ReturnCode
Indica o resultado da operação do servidor que gerou a mensagem de resultado original. Passe NULL para ignorar esse campo.
[out, optional] MatchedDNs
Um ponteiro para uma cadeia de caracteres larga terminada em nulo. No caso de um retorno de LDAP_NO_SUCH_OBJECT, esse parâmetro de resultado é preenchido com um nome diferenciado indicando quanto do nome na solicitação foi reconhecido. Passe NULL para ignorar esse campo.
[out, optional] ErrorMessage
Um ponteiro para uma cadeia de caracteres ampla terminada em nulo que contém o conteúdo do campo de mensagem de erro do parâmetro ResultMessage . Passe NULL para ignorar esse campo.
[out, optional] Referrals
Um ponteiro para uma cadeia de caracteres ampla terminada em nulo que contém o conteúdo do campo de referências do parâmetro ResultMessage , indicando zero ou mais servidores LDAP alternativos em que a solicitação deve ser repetida. Passe NULL para ignorar esse campo.
[out, optional] ServerControls
Esse parâmetro de resultado é preenchido com uma matriz alocada de controles copiados do parâmetro ResultMessage .
[in] Freeit
Determina se o parâmetro ResultMessage é liberado. Você pode passar qualquer valor diferente de zero para o parâmetro Freeit para liberar o ponteiro ResultMessage quando ele não for mais necessário ou chamar ldap_msgfree para liberar o resultado mais tarde.
Valor retornado
Se a função for bem-sucedida, o valor retornado será LDAP_SUCCESS.
Se a função falhar, será exibido um código de erro. Consulte Valores retornados para obter mais informações.
Comentários
A função ldap_parse_result percorre uma cadeia de respostas do servidor em busca de mensagens de resultado a serem analisadas. Use essa função se quiser acessar as indicações, os nomes diferenciados correspondentes ou os controles de servidor retornados. A função ignora mensagens do tipo LDAP_RES_SEARCH_ENTRY e LDAP_RES_SEARCH_REFERENCE.
Quando eles não forem mais necessários, libere as cadeias de caracteres ErrorMessage e MatchedDNs chamando ldap_memfree. Libere a matriz Indicações chamando ldap_value_free. Libere o ServerControls chamando ldap_controls_free.
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 |