funzione ldap_modify_s (winldap.h)

Articolo
03/13/2024

La funzione ldap_modify_s modifica una voce esistente.

Sintassi

WINLDAPAPI ULONG LDAPAPI ldap_modify_s(
  [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 di modifiche con terminazione Null da apportare alla voce.

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_s avvia un'operazione sincrona 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, la funzione rimuove l'attributo se non rimangono valori. Tutte le modifiche vengono eseguite nell'ordine in cui sono elencate.

Multithreading: le chiamate a ldap_modify_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 qualsiasi altra operazione.

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