Struttura LDAPModA (winldap.h)

Articolo
11/20/2024

La struttura LDAPMod contiene i dati necessari per eseguire un'operazione di modifica.

Sintassi

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

Membri

mod_op

Specifica uno dei valori seguenti per indicare l'operazione di modifica da eseguire.

È possibile utilizzare l'operatore di OR bit per bit per combinare il valore dell'operazione con LDAP_MOD_BVALUES per indicare che l'unione mod_vals utilizza il membro modv_bvals. Se LDAP_MOD_BVALUES non è impostato, l'unione utilizza il membro modv_strvals.

LDAP_MOD_ADD (0x00)

Aggiunge un valore alla voce. I valori forniti vengono aggiunti ai valori esistenti nell'attributo .

LDAP_MOD_DELETE (0x01)

Elimina un valore nella voce. I valori specificati vengono eliminati dai valori dell'attributo corrente.

LDAP_MOD_REPLACE (0x02)

Sostituisce un valore nella voce. I valori specificati sostituiscono i valori di attributo esistenti.

mod_type

Puntatore a una stringa con terminazione Null che specifica il nome dell'attributo da modificare.

mod_vals

Puntatore a una matrice di valori, se presenti, per aggiungere, eliminare o sostituire. Se mop_op non include il flag LDAP_MOD_BVALUES, il membro modv_strvals è un puntatore a una matrice di stringhe con terminazione Null. Se mop_op include LDAP_MOD_BVALUES, il membro modv_bvals è un puntatore a una matrice di puntatori berval, utile per specificare valori binari.

mod_vals.modv_strvals

Puntatore a una matrice con terminazione Null di stringhe con terminazione Null. L'ultimo elemento della matrice deve essere un puntatore NULL.

mod_vals.modv_bvals

Puntatore a una matricenullcon terminazione null di berval. L'ultimo elemento della matrice deve essere un puntatore NULL.

Osservazioni

Assegnare valori ai campi della struttura LDAPMod prima di chiamare una funzione di modifica ( ldap_add*o ldap_modify*).

ldap_modify* con l'operazione di LDAP_MOD_REPLACE non elimina un attributo quando viene passato un puntatore Null. Tuttavia, LDAP_MOD_DELETE elimina l'intero attributo quando mod_vals è impostato su NULL.

Quando si passa una struttura LDAPMod nelle funzioni di ldap_add*, solo il flag LDAP_MOD_BVALUES è significativo. La creazione di un nuovo oggetto implica l'aggiunta di valori.

Nota

L'intestazione winldap.h definisce LDAPMod come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.