función ldap_parse_result (winldap.h)
La función ldap_parse_result analiza las respuestas del servidor y devuelve los campos adecuados.
Sintaxis
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
Identificador de sesión.
[in] ResultMessage
Resultado de una operación LDAP devuelta por una de las llamadas de operación sincrónicas o por ldap_result para una operación asincrónica.
[out, optional] ReturnCode
Indica el resultado de la operación del servidor que generó el mensaje de resultado original. Pase NULL para omitir este campo.
[out, optional] MatchedDNs
Puntero a una cadena ancha terminada en NULL. En el caso de una devolución de LDAP_NO_SUCH_OBJECT, este parámetro de resultado se rellena con un nombre distintivo que indica la cantidad del nombre en la solicitud. Pase NULL para omitir este campo.
[out, optional] ErrorMessage
Puntero a una cadena ancha terminada en NULL que contiene el contenido del campo de mensaje de error del parámetro ResultMessage . Pase NULL para omitir este campo.
[out, optional] Referrals
Puntero a una cadena ancha terminada en NULL que contiene el contenido del campo de referencias del parámetro ResultMessage , que indica cero o más servidores LDAP alternativos donde se debe reintentar la solicitud. Pase NULL para omitir este campo.
[out, optional] ServerControls
Este parámetro de resultado se rellena con una matriz asignada de controles copiados del parámetro ResultMessage .
[in] Freeit
Determina si el parámetro ResultMessage está liberado. Puede pasar cualquier valor distinto de cero al parámetro Freeit para liberar el puntero ResultMessage cuando ya no sea necesario, o puede llamar a ldap_msgfree para liberar el resultado más adelante.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es LDAP_SUCCESS.
Si la función presenta un error, devuelve un código de error. Consulte Valores devueltos para obtener más información.
Comentarios
La función ldap_parse_result atraviesa una cadena de respuestas de servidor que buscan que se analicen los mensajes de resultado. Use esta función si desea acceder a las referencias, a los nombres distintivos coincidentes o a los controles de servidor devueltos. La función omite los mensajes de tipo LDAP_RES_SEARCH_ENTRY y LDAP_RES_SEARCH_REFERENCE.
Cuando ya no se necesiten, libere las cadenas ErrorMessage y MatchedDNs llamando a ldap_memfree. Libere la matriz Referencias llamando a ldap_value_free. Libere serverControls llamando a ldap_controls_free.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | winldap.h |
| Library | Wldap32.lib |
| Archivo DLL | Wldap32.dll |