función ldap_modify (winldap.h)
La función ldap_modify cambia una entrada existente.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_modify(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPModA * [] mods
);
Parámetros
[in] ld
Identificador de sesión.
[in] dn
Puntero a una cadena terminada en null que contiene el nombre de la entrada que se va a modificar.
[in] mods
Matriz terminada en null de modificaciones que se van a realizar en la entrada.
Valor devuelto
Si la función se ejecuta correctamente, devuelve el identificador de mensaje de la operación de modificación.
Si se produce un error en la función, devuelve –1 y establece los parámetros de error de sesión en la estructura de datos LDAP .
Comentarios
La función ldap_modify inicia una operación asincrónica para modificar una entrada existente. Si los valores se agregan o reemplazan en la entrada, la función crea el atributo, si es necesario. Si se eliminan los valores y no quedan valores, la función quita el atributo . Todas las modificaciones se realizan en el orden en que se muestran.
Como función asincrónica, ldap_modify devuelve un identificador de mensaje para la operación. Llame a ldap_result con el identificador de mensaje para obtener el resultado de la operación. Para cancelar una operación asincrónica antes de que se haya completado, llame a ldap_abandon.
Si prefiere que la función devuelva los resultados directamente, use la rutina sincrónica ldap_modify_s. Use ldap_modify_ext o ldap_modify_ext_s si necesita compatibilidad con los controles de cliente y servidor LDAP 3.
Multithreading: las llamadas a ldap_modify son seguras para subprocesos, siempre que LdapGetLastError se use para recuperar el código de error de sesión real cuando la llamada de función devuelve el código de error -1.
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 |