ldap_modify_ext-Funktion (winldap.h)
Die ldap_modify_ext-Funktion ändert einen vorhandenen Eintrag.
Syntax
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
);
Parameter
[in] ld
Das Sitzungshandle.
[in] dn
Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des zu ändernden Eintrags enthält.
[in] mods
Ein Array mit NULL-Beendigung von Änderungen, die am Eintrag vorgenommen werden sollen.
[in] ServerControls
Eine Liste der LDAP-Serversteuerelemente.
[in] ClientControls
Eine Liste von Clientsteuerelementen
[out] MessageNumber
Dieser Ergebnisparameter wird auf die Nachrichten-ID der Anforderung festgelegt, wenn der Aufruf erfolgreich ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Zurückgeben von Werten .
Hinweise
Die funktion ldap_modify_ext initiiert einen asynchronen Vorgang, um einen vorhandenen Eintrag zu ändern. Wenn Werte im Eintrag hinzugefügt oder ersetzt werden, erstellt die Funktion ggf. das Attribut. Wenn Werte gelöscht werden und keine Werte verbleiben, entfernt die Funktion das Attribut. Alle Änderungen werden in der Reihenfolge durchgeführt, in der sie aufgelistet sind.
Die Parameter und Auswirkungen von ldap_modify_ext subsumieren die von ldap_modify. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen sowie zur Threadsicherheit.
Bei erfolgreicher Ausführung übergibt ldap_modify_ext die Nachrichten-ID für den Vorgang im MessageNumber-Parameter zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten. Wenn Sie möchten, dass die Funktion das Ergebnis direkt zurückgibt, verwenden Sie die synchrone erweiterte Funktion ldap_modify_ext_s.
Multithreading: Aufrufe von ldap_modify_ext sind threadsicher.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |