ldap_abandon-Funktion (winldap.h)
Ein Client ruft ldap_abandon auf, um einen prozessinternen asynchronen LDAP-Aufruf abzubrechen.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_abandon(
[in] LDAP *ld,
[in] ULONG msgid
);
Parameter
[in] ld
Das Sitzungshandle.
[in] msgid
Die Nachrichten-ID des abzubrechenden Anrufs. Asynchrone Funktionen wie ldap_search und ldap_modify geben diese Meldungs-ID zurück, wenn sie einen Vorgang initiieren.
Rückgabewert
Wenn die Funktion erfolgreich ist, d. h. wenn der Abbruchvorgang erfolgreich ist, ist der Rückgabewert null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert –1.
Hinweise
Die ldap_abandon-Funktion überprüft zunächst, ob der Vorgang abgeschlossen wurde. Falls vorhanden, wird die Nachrichten-ID gelöscht. Andernfalls wird der Aufruf an den Server gesendet, um den Vorgang abzubrechen. Beachten Sie, dass ein erfolgreicher Aufruf von ldap_abandon die Nachrichten-ID zerstört. Daher können Sie ldap_result nicht aufrufen, um Ergebnisse mit dieser Meldungs-ID zu erhalten, auch wenn der Server den Vorgang abgeschlossen hat.
Es gibt keine Serverantwort auf ldap_abandon. Daher gibt es keine Garantie, dass der Aufruf den Server erreicht hat.
Multithreading: Aufrufe an ldap_abandon sind threadsicher.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | winldap.h |
| Bibliothek | Wldap32.lib |
| DLL | Wldap32.dll |