Estructura LDAPModA (winldap.h)

Artículo
11/20/2024

La estructura LDAPMod contiene los datos necesarios para realizar una operación de modificación.

Sintaxis

typedef struct ldapmodA {
  ULONG mod_op;
  PCHAR mod_type;
  union {
    PCHAR  *modv_strvals;
    berval **modv_bvals;
  } mod_vals;
} LDAPModA, *PLDAPModA;

Miembros

mod_op

Especifica uno de los siguientes valores para indicar la operación de modificación que se va a realizar.

Puede usar el operador OR bit a bit para combinar el valor de la operación con LDAP_MOD_BVALUES para indicar que la unión mod_vals usa el miembro modv_bvals. Si no se establece LDAP_MOD_BVALUES, la unión usa el miembro modv_strvals.

LDAP_MOD_ADD (0x00)

Agrega un valor a la entrada. Los valores proporcionados se anexan a los valores existentes en el atributo .

LDAP_MOD_DELETE (0x01)

Elimina un valor en la entrada. Los valores proporcionados se eliminan de los valores de atributo actuales.

LDAP_MOD_REPLACE (0x02)

Reemplaza un valor en la entrada. Los valores proporcionados reemplazan los valores de atributo existentes.

mod_type

Puntero a una cadena terminada en null que especifica el nombre del atributo que se va a modificar.

mod_vals

Puntero a una matriz de valores, si existe, para agregar, eliminar o reemplazar. Si mop_op no incluye la marca LDAP_MOD_BVALUES, el miembro modv_strvals es un puntero a una matriz de cadenas terminadas en NULL. Si mop_op incluye LDAP_MOD_BVALUES, el miembro modv_bvals es un puntero a una matriz de punteros berval, lo que resulta útil para especificar valores binarios.

mod_vals.modv_strvals

Puntero a una matriz terminada en null de cadenas terminadas en NULL. El último elemento de la matriz debe ser un puntero NULL.

mod_vals.modv_bvals

Puntero a un matriz terminadaNULL de punteros berval de berval. El último elemento de la matriz debe ser un puntero NULL.

Observaciones

Asigne valores a los campos de la estructura ldapMod de antes de llamar a una función de modificación ( ldap_add*, o ldap_modify*).

ldap_modify* con la operación de LDAP_MOD_REPLACE no elimina un atributo cuando se pasa un puntero nulo. Sin embargo, LDAP_MOD_DELETE elimina todo el atributo cuando mod_vals se establece en NULL.

Al pasar una estructura de LDAPMod a las funciones de ldap_add* ldap_add*, solo la marca de LDAP_MOD_BVALUES es significativa. La creación de un nuevo objeto implica agregar valores a él.

Nota

El encabezado winldap.h define LDAPMod como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.