funzione ldap_add_ext (winldap.h)

La funzione ldap_add_ext avvia un'operazione di aggiunta asincrona a un albero. L'elemento padre della voce aggiunta deve esistere oppure l'elemento padre deve essere vuoto (uguale al nome distinto della radice) affinché un'operazione di aggiunta abbia esito positivo.

Sintassi

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
);

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. Per altre informazioni, vedere la sezione Osservazioni.

[in] ServerControls

Elenco di controlli server LDAP.

[in] ClientControls

Elenco di controlli client.

[out] MessageNumber

ID del messaggio per la richiesta.

Valore restituito

Se la funzione ha esito positivo, viene restituito LDAP_SUCCESS .

Se la funzione ha esito negativo, viene restituito un codice di errore. Per altre informazioni, vedere Gestione degli errori.

Commenti

I parametri e gli effetti di ldap_add_ext includono quelli di ldap_add. La routine estesa include parametri aggiuntivi per supportare controlli client e server e thread safety.

Prima di chiamare ldap_add_ext, creare una voce specificandone gli attributi nelle strutture LDAPMod . Impostare il campo mod_op di ogni struttura su LDAP_MOD_ADD e impostare i campi mod_type e mod_vals in base alle esigenze della voce.

Se l'operazione ha esito positivo, ldap_add_ext passa l'ID del messaggio al chiamante come parametro. Chiamare ldap_result con l'ID del messaggio per ottenere il risultato dell'operazione.

Per ottenere i risultati restituiti direttamente, usare la funzione sincrona ldap_add_ext_s.

Multithreading: le chiamate a ldap_add_ext sono thread-safe.

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.

 

ServerControls e ClientControls sono facoltativi e devono essere impostati su NULL se non usati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	winldap.h
Libreria	Wldap32.lib
DLL	Wldap32.dll

Vedi anche

Gestione degli errori

Controlli estesi

Funzioni

LDAPMod

Modifica di una voce di directory

Uso dei controlli

ldap_add

ldap_add_ext_s

ldap_bind

ldap_result

ldap_simple_bind