funzione ldap_modify (winldap.h)
La funzione ldap_modify modifica una voce esistente.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_modify(
[in] LDAP *ld,
[in] PSTR dn,
[in] LDAPModA * [] mods
);
Parametri
[in] ld
Handle di sessione.
[in] dn
Puntatore a una stringa con terminazione null contenente il nome della voce da modificare.
[in] mods
Matrice con terminazione null delle modifiche da apportare alla voce.
Valore restituito
Se la funzione ha esito positivo, restituisce l'ID messaggio dell'operazione di modifica.
Se la funzione ha esito negativo, restituisce –1 e imposta i parametri di errore della sessione nella struttura di dati LDAP .
Commenti
La funzione ldap_modify avvia un'operazione asincrona per modificare una voce esistente. Se i valori vengono aggiunti o sostituiti nella voce, la funzione crea l'attributo, se necessario. Se i valori vengono eliminati e non rimangono valori, la funzione rimuove l'attributo. Tutte le modifiche vengono eseguite nell'ordine in cui sono elencate.
Come funzione asincrona, ldap_modify restituisce un ID messaggio per l'operazione. Chiamare ldap_result con l'ID messaggio per ottenere il risultato dell'operazione. Per annullare un'operazione asincrona prima del completamento, chiamare ldap_abandon.
Se si preferisce che la funzione restituisca direttamente i risultati, usare la routine sincrona ldap_modify_s. Usare ldap_modify_ext o ldap_modify_ext_s se è necessario il supporto per i controlli server e client LDAP 3.
Multithreading: le chiamate a ldap_modify sono thread-safe, a condizione che LdapGetLastError venga usato per recuperare il codice di errore della sessione effettivo quando la chiamata di funzione restituisce il codice di errore -1.
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 |