función ldap_add (winldap.h)

Artículo
08/27/2023

La función ldap_add inicia una operación de adición asincrónica en un árbol de directorios. Para que una operación de adición se realice correctamente, el elemento primario de la entrada agregada debe existir o el elemento primario debe estar vacío (igual al nombre distintivo de la raíz).

Sintaxis

WINLDAPAPI ULONG LDAPAPI ldap_add(
  [in] LDAP         *ld,
  [in] PSTR         dn,
  [in] LDAPMod * [] attrs
);

Parámetros

[in] ld

Identificador de sesión.

[in] dn

Puntero a una cadena terminada en null que contiene el nombre distintivo de la entrada que se va a agregar.

[in] attrs

Matriz de punteros a estructuras LDAPMod . Cada estructura especifica un único atributo.

Valor devuelto

Si la función se ejecuta correctamente, se devuelve el identificador de mensaje de la operación de adició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 . Para recuperar los datos de error, use LdapGetLastError.

Comentarios

Antes de llamar a ldap_add, cree una entrada especificando sus atributos en estructuras LDAPMod . Establezca el miembro mod_op de cada estructura en LDAP_MOD_ADD y establezca los miembros mod_type y mod_vals según corresponda para la entrada.

Como función asincrónica, ldap_add 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 de adición asincrónica antes de que se haya completado, llame a ldap_abandon.

Para que los resultados se devuelvan directamente, use la función sincrónica ldap_add_s. Use ldap_add_ext o ldap_add_ext_s para habilitar la compatibilidad con los controles de cliente y servidor LDAP 3.

Multithreading: las llamadas a ldap_add 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.

Nota Al conectarse a un servidor LDAP 2, la aplicación debe realizar una operación de enlace llamando a una de las rutinas de ldap_bind o ldap_simple_bind antes de intentar otras operaciones.

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