función ldap_add_ext (winldap.h)

Artículo
03/08/2023

La función ldap_add_ext inicia una operación de adición asincrónica a un árbol. 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) para que una operación de adición se realice correctamente.

Sintaxis

WINLDAPAPI ULONG LDAPAPI ldap_add_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  LDAPModA * [] attrs,
  [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 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.

[out] MessageNumber

Identificador del mensaje de la solicitud.

Valor devuelto

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

Si se produce un error en la función, se devuelve un código de error. Para más información, consulte Control de errores.

Comentarios

Los parámetros y efectos de ldap_add_ext incluyen los de ldap_add. La rutina extendida incluye parámetros adicionales para admitir controles de cliente y servidor y seguridad de subprocesos.

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

Si la operación se realiza correctamente, ldap_add_ext pasa el identificador de mensaje al autor de la llamada como parámetro. Llame a ldap_result con el identificador de mensaje para obtener el resultado de la operación.

Para que los resultados se devuelvan directamente, use la función sincrónica ldap_add_ext_s.

Multithreaded: las llamadas a ldap_add_ext 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