funzione ldap_add_ext_s (winldap.h)

La funzione ldap_add_ext_s avvia un'operazione di aggiunta sincrona a un albero. 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_ext_s(
  [in] LDAP          *ld,
  [in] const PSTR    dn,
  [in] LDAPModA * [] attrs,
  [in] PLDAPControlA *ServerControls,
  [in] PLDAPControlA *ClientControls
);

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.

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 Valori restituiti.

Commenti

I parametri e gli effetti di ldap_add_ext_s includono quelli di ldap_add_s. La routine estesa include parametri aggiuntivi per supportare i controlli client e server.

Prima di chiamare ldap_add_ext_s, 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.

Al termine dell'operazione di aggiunta, ldap_add_ext_s torna al chiamante. Usare ldap_add_ext se si preferisce che l'operazione venga completata in modo asincrono.

Multithreading: le chiamate a ldap_add_ext_s 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

Controlli estesi

Funzioni

LDAPMod

Valori restituiti

Uso dei controlli

ldap_add_ext

ldap_add_s

ldap_bind

ldap_simple_bind