funzione ldap_modify_ext (winldap.h)
La funzione ldap_modify_ext modifica una voce esistente.
Sintassi
WINLDAPAPI ULONG LDAPAPI ldap_modify_ext(
[in] LDAP *ld,
[in] const PSTR dn,
[in] LDAPModA * [] mods,
[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 della voce da modificare.
[in] mods
Matrice di modifiche con terminazione Null da apportare alla voce.
[in] ServerControls
Elenco di controlli server LDAP.
[in] ClientControls
Elenco di controlli client
[out] MessageNumber
Questo parametro di risultato viene impostato sull'ID messaggio della richiesta se la chiamata ha esito positivo.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene LDAP_SUCCESS.
Se la funzione non viene completata, restituisce un codice di errore. Per altre informazioni, vedere Valori restituiti .
Commenti
La funzione ldap_modify_ext 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.
I parametri e gli effetti di ldap_modify_ext subsumono quelli di ldap_modify. La routine estesa include parametri aggiuntivi per supportare i controlli client e server e thread safety.
In caso di esito positivo, ldap_modify_ext restituisce l'ID messaggio per l'operazione nel parametro MessageNumber . Chiamare ldap_result con l'ID del messaggio per ottenere il risultato dell'operazione. Se si preferisce che la funzione restituisca direttamente il risultato, usare la funzione estesa sincrona ldap_modify_ext_s.
Multithreading: le chiamate a ldap_modify_ext sono thread-safe.
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 |