ldap_result-Funktion (winldap.h)
Die ldap_result-Funktion ruft das Ergebnis eines asynchronen Vorgangs ab.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
Parameter
[in] ld
Das Sitzungshandle.
[in] msgid
Die Nachrichten-ID des Vorgangs oder die Konstante LDAP_RES_ANY, wenn ein Ergebnis erforderlich ist.
[in] all
Gibt an, wie viele Nachrichten in einem einzelnen Aufruf von ldap_result abgerufen werden. Dieser Parameter hat nur Bedeutung für Suchergebnisse. Übergeben Sie die konstante LDAP_MSG_ONE (0x00), um jeweils eine Nachricht abzurufen. Übergeben Sie LDAP_MSG_ALL (0x01), um anzufordern, dass alle Ergebnisse einer Suche empfangen werden, bevor alle Ergebnisse in einer einzigen Kette zurückgegeben werden. Übergeben Sie LDAP_MSG_RECEIVED (0x02), um anzugeben, dass alle bisher abgerufenen Ergebnisse in der Ergebniskette zurückgegeben werden sollen.
[in] timeout
Ein Timeout, das angibt, wie lange (in Sekunden) auf die Rückgabe von Ergebnissen gewartet werden soll. Ein NULL-Wert bewirkt , dass ldap_result blockiert wird, bis Ergebnisse verfügbar sind. Ein Timeoutwert von 0 Sekunden gibt ein Abrufverhalten an.
[out] res
Enthält die Ergebnisse des Vorgangs. Alle zurückgegebenen Ergebnisse sollten mit einem Aufruf an ldap_msgfree freigegeben werden, sobald sie von der Anwendung nicht mehr benötigt werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie einen der folgenden Werte zurück, um den Typ des ersten Ergebnisses im res-Parameter anzugeben. Wenn das Timeout abläuft, gibt die Funktion 0 zurück.
Wenn die Funktion fehlschlägt, gibt sie –1 zurück und legt die Sitzungsfehlerparameter in der LDAP-Datenstruktur fest.
Hinweise
Die ldap_result-Funktion ruft das Ergebnis eines vorherigen, asynchron initiierten Vorgangs ab. Beachten Sie, dass ldap_result je nach Bezeichnung tatsächlich eine Liste oder "Kette" von Nachrichten zurückgeben können.
Für verbindungsloses LDAP müssen Sie sowohl ein LDAP-Verbindungshandle als auch eine Nachrichten-ID übergeben, um sicherzustellen, dass Sie die richtigen Ergebnisse erhalten. Die LDAP-Laufzeit sendet die Anforderung weiterhin, bis sie eine Antwort erhält.
Multithreading: Aufrufe an ldap_result 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 |