funzione ldap_modify_ext (winldap.h)

Articolo
03/04/2024

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