función ldap_modify_ext (winldap.h)
La función ldap_modify_ext cambia una entrada existente.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[in] PLDAPControlA *ServerControls,
[in] PLDAPControlA *ClientControls,
[out] ULONG *MessageNumber
);
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.
[in] ServerControls
Lista de controles de servidor LDAP.
[in] ClientControls
Una lista de controles de cliente
[out] MessageNumber
Este parámetro de resultado se establece en el identificador de mensaje de la solicitud si la llamada se realiza correctamente.
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_modify_ext 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.
Los parámetros y efectos de ldap_modify_ext suume los de ldap_modify. La rutina extendida incluye parámetros adicionales para admitir controles de cliente y servidor y seguridad para subprocesos.
Si se ejecuta correctamente, ldap_modify_ext devuelve el identificador del mensaje para la operación en el parámetro MessageNumber . Llame a ldap_result con el identificador de mensaje para obtener el resultado de la operación. Si prefiere que la función devuelva el resultado directamente, use la función extendida sincrónica ldap_modify_ext_s.
Multithreading: las llamadas a ldap_modify_ext son seguras para subprocesos.
Requisitos
| Requisito | Value |
|---|---|
| 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 |