función ldap_add_ext_s (winldap.h)

Artículo
08/27/2023

La función ldap_add_ext_s inicia una operación de adición sincrónica a un árbol. 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_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

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. Para obtener más información, vea la sección Comentarios.

[in] ServerControls

Lista de controles de servidor LDAP.

[in] ClientControls

Lista de controles de cliente.

Valor devuelto

Si la función se ejecuta correctamente, se devuelve LDAP_SUCCESS .

Si se produce un error en la función, se devuelve un código de error. Para obtener más información, vea Valores devueltos.

Comentarios

Los parámetros y efectos de ldap_add_ext_s incluyen los de ldap_add_s. La rutina extendida incluye parámetros adicionales para admitir controles de cliente y servidor.

Antes de llamar a ldap_add_ext_s, 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.

Tras completar la operación de adición, ldap_add_ext_s vuelve al autor de la llamada. Use ldap_add_ext si prefiere que la operación se complete de forma asincrónica.

Multithreading: las llamadas a ldap_add_ext_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 otras operaciones.

ServerControls y ClientControls son opcionales y deben establecerse en NULL si no se usan.

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