ldap_delete_ext-Funktion (winldap.h)

2024-03-04

Die ldap_delete_ext-Funktion ist eine erweiterte Routine, die einen Blatteintrag aus der Verzeichnisstruktur entfernt.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_delete_ext(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

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

[in] ServerControls

Optional. Liste der LDAP-Serversteuerelemente. Wenn nicht verwendet, legen Sie diesen Parameter auf NULL fest.

[in] ClientControls

Optional. Liste der Clientsteuerelemente. Wenn nicht verwendet, legen Sie diesen Parameter auf NULL fest.

[out] MessageNumber

Nachrichten-ID für die Anforderung.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird LDAP_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.

Hinweise

Die ldap_delete_ext-Funktion entfernt einen Blatteintrag aus der Verzeichnisstruktur. LDAP unterstützt das Löschen ganzer Unterstrukturen in einem einzelnen Vorgang nicht, es gibt jedoch ein erweitertes Steuerelement , LDAP_SERVER_TREE_DELETE_OID, das zum Ausführen dieses Vorgangs verwendet wird.

Zu den Parametern und Auswirkungen von ldap_delete_ext gehören die Parameter ldap_delete. Die erweiterte Routine umfasst Parameter zur Unterstützung von Client- und Serversteuerungen und Threadsicherheit.

Wenn der Vorgang erfolgreich ist, übergibt ldap_delete_ext die Nachrichten-ID als Parameter an den Aufrufer, wenn der Vorgang erfolgreich zurückgegeben wird. Um das Ergebnis des Vorgangs zu erhalten, rufen Sie ldap_result mit der Nachrichten-ID auf.

Damit die Funktion die Ergebnisse direkt zurückgibt, verwenden Sie die synchrone Routine-ldap_delete_ext_s.

Multithreading: Aufrufe an ldap_delete_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