función ldap_add_s (winldap.h)

Artículo
08/27/2023

La función ldap_add_s inicia una operación de adición sincrónica que agrega una entrada a un árbol. El elemento primario de la entrada que se va a agregar ya debe existir o el elemento primario debe estar vacío (igual al nombre distintivo raíz) para que una operación de adición se realice correctamente.

Sintaxis

WINLDAPAPI ULONG LDAPAPI ldap_add_s(
  [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 terminada en null de punteros a estructuras LDAPMod . Cada estructura especifica un único atributo. Vea Comentarios para obtener más información.

Valor devuelto

Si la función se ejecuta correctamente, se LDAP_SUCCESS el valor devuelto.

Si la función presenta un error, devuelve un código de error. Consulte Valores devueltos para obtener más información.

Comentarios

Antes de llamar a ldap_add_s. debe crear 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. Consulte Modificación de una entrada de directorio para obtener más información.

Después de completar la operación de adición, ldap_add_s vuelve al autor de la llamada. Use ldap_add si prefiere realizar la operación de forma asincrónica.

Multithreading: las llamadas a ldap_add_s son seguras para subprocesos.

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 cualquier otra operación.

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