Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione ldap_add avvia un'operazione di aggiunta asincrona a un albero di directory. Affinché un'operazione di aggiunta abbia esito positivo, l'elemento padre della voce aggiunta deve esistere oppure l'elemento padre deve essere vuoto (uguale al nome distinto della radice).
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_add(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPMod * [] attrs
);
Parametri
[in] ld
Handle di sessione.
[in] dn
Puntatore a una stringa con terminazione Null contenente il nome distinto della voce da aggiungere.
[in] attrs
Matrice di puntatori alle strutture LDAPMod . Ogni struttura specifica un singolo attributo.
Valore restituito
Se la funzione ha esito positivo, viene restituito l'ID messaggio dell'operazione di aggiunta.
Se la funzione ha esito negativo, restituisce –1 e imposta i parametri di errore della sessione nella struttura dei dati LDAP . Per recuperare i dati degli errori, usare LdapGetLastError.
Commenti
Prima di chiamare ldap_add, creare una voce specificandone gli attributi nelle strutture LDAPMod . Impostare il membro mod_op di ogni struttura su LDAP_MOD_ADD e impostare i membri mod_type e mod_vals in base alle esigenze della voce.
Come funzione asincrona, ldap_add restituisce un ID messaggio per l'operazione. Chiamare ldap_result con l'ID del messaggio per ottenere il risultato dell'operazione. Per annullare un'operazione di aggiunta asincrona prima del completamento, chiamare ldap_abandon.
Per ottenere i risultati restituiti direttamente, usare la funzione sincrona ldap_add_s. Usare ldap_add_ext o ldap_add_ext_s per abilitare il supporto per i controlli client e server LDAP 3.
Multithreading: le chiamate a ldap_add sono thread-safe, a condizione che LdapGetLastError venga usato per recuperare il codice di errore di sessione effettivo quando la chiamata di funzione restituisce il codice di errore -1.
Nota Quando ci si connette a un server LDAP 2, l'applicazione deve eseguire un'operazione di associazione chiamando una delle routine ldap_bind o ldap_simple_bind prima di tentare altre operazioni.
Requisiti
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Piattaforma di destinazione | Windows |
| Intestazione | winldap.h |
| Libreria | Wldap32.lib |
| DLL | Wldap32.dll |