ldap_get_next_page-Funktion (winldap.h)
Die ldap_get_next_page-Funktion gibt die nächste Seite in einer Sequenz von asynchronen ausgelagerten Suchergebnissen zurück.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_get_next_page(
[in] PLDAP ExternalHandle,
[in] PLDAPSearch SearchHandle,
[in] ULONG PageSize,
[out] ULONG *MessageNumber
);
Parameter
[in] ExternalHandle
Sitzungshandle.
[in] SearchHandle
Suchblockhandle.
[in] PageSize
Die Anzahl der Einträge, die auf einer einzelnen Seite zurückgegeben werden sollen.
[out] MessageNumber
Die Nachrichten-ID für die Anforderung.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.
Wenn die Funktion fehlschlägt, gibt sie einen Fehlercode-Rückgabewert zurück. Weitere Informationen finden Sie unter Rückgabewerte.
Hinweise
Die ldap_get_next_page-Funktion ist Teil der Schnittstelle für das einfache, asynchrone Paging von Suchergebnissen. Verwenden Sie das Suchhandle, das von einem ersten Aufruf an ldap_search_init_page zurückgegeben wurde, und geben Sie im PageSize-Parameter die Anzahl der auf einer Seite zurückgegebenen Einträge an. Legen Sie PageSize auf Null fest, um eine Suche abzubrechen.
Beachten Sie, dass Sie nach jedem Aufruf von ldap_get_next_pageldap_get_paged_count für jede Gruppe von Ergebnissen aufrufen müssen, die vom Server mit ldap_result zurückgegeben werden. Dadurch kann die LDAP-Laufzeit das Cookie speichern, das der Server zurückgegeben hat, um den Suchstatus beizubehalten. Abgesehen vom Aufrufen von ldap_get_paged_count können die von ldap_get_next_page zurückgegebenen Ergebnisse als jedes andere Suchergebnis behandelt werden und müssen nach Abschluss durch Aufrufen ldap_msgfree freigegeben werden.
Beachten Sie beim Analysieren des Resultsets, dass es möglich ist, dass der Server eine leere Ergebnisseite zurückgibt und dennoch mit einem LDAP_SUCCESS Rückgabewert reagiert. Dies gibt an, dass der Server aufgrund eines Timeouts oder eines anderen Grunds keine Ergebnisseite abrufen konnte, aber die Suchanforderung nicht abgeschlossen hat. Das richtige Verhalten in diesem instance besteht darin, weiterhin ldap_get_next_page aufzurufen, bis entweder eine andere Ergebnisseite erfolgreich abgerufen, ein Fehlercode zurückgegeben oder LDAP_NO_RESULTS_RETURNED zurückgegeben wird, um anzugeben, dass die Suche abgeschlossen ist.
Wenn Sie seitenseitige Suchergebnisse lieber synchron abrufen möchten, verwenden Sie ldap_get_next_page_s.
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 |