ldap_delete-Funktion (winldap.h)

2024-03-06

Die ldap_delete-Funktion löscht einen Eintrag aus der Verzeichnisstruktur.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_delete(
  [in] LDAP *ld,
  [in] PSTR dn
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den distinguished Name des zu löschenden Eintrags enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Meldungs-ID des Löschvorgangs zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert –1, und die Funktion legt die Sitzungsfehlerparameter in der LDAP-Datenstruktur fest. Verwenden Sie LdapGetLastError, um diesen Wert abzurufen.

Hinweise

Rufen Sie ldap_delete auf, um einen Blatteintrag aus der Verzeichnisstruktur zu entfernen. Beachten Sie, dass LDAP das Löschen ganzer Unterstrukturen in einem einzelnen Vorgang nicht unterstützt. Als asynchrone Funktion gibt ldap_delete eine Nachrichten-ID für den Vorgang zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten. Um einen asynchronen Löschvorgang abzubrechen, bevor er abgeschlossen ist, rufen Sie ldap_abandon auf.

Damit die Funktion die Ergebnisse direkt zurückgibt, verwenden Sie die synchrone Routine ldap_delete_s. Verwenden Sie ldap_delete_ext oder ldap_delete_ext_s , um die Unterstützung für LDAP 3-Server- und Clientsteuerelemente zu aktivieren.

Multithreading: Aufrufe von ldap_delete sind threadsicher, sofern LdapGetLastError verwendet wird, um den tatsächlichen Sitzungsfehlercode abzurufen, wenn der Funktionsaufruf den Fehlercode -1 zurückgibt.

Hinweis Beim Herstellen einer Verbindung mit einem LDAP 2-Server muss die Anwendung einen Bindungsvorgang ausführen, indem sie eine der ldap_bind oder ldap_simple_bind Routinen aufruft, bevor sie andere Vorgänge versucht.

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