ldap_parse_page_controlA-Funktion (winldap.h)

2024-03-04

Die ldap_parse_page_control analysiert die Ergebnisse einer Suche in Seiten.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_parse_page_controlA(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlA *ServerControls,
  [out] ULONG         *TotalCount,
  [out] berval        **Cookie
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] ServerControls

Ein Array von Steuerelementen, das ein Seitensteuerelement enthält. Das Seitensteuerelement enthält die vom Server zurückgegebenen Cookie- und Gesamtanzahlfelder.

[out] TotalCount

Ein Zeiger auf die Gesamtanzahl der auf dieser Seite zurückgegebenen Einträge (optional).

[out] Cookie

Ein undurchsichtiges Cookie, das vom Server verwendet wird, um seinen Speicherort im Resultset zu bestimmen. Verwenden Sie ber_bvfree kostenlos.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.

Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Zurückgeben von Werten .

Hinweise

Verwenden Sie ldap_parse_page_control in Verbindung mit ldap_create_page_control und ldap_parse_result , um das einfache Paging von Ergebnissen mithilfe von Steuerelementen zu implementieren. Nachdem Sie ldap_parse_page_control aufgerufen haben , um die Serversteuerelemente abzurufen und das Cookie aus dem Suchergebnis zu extrahieren, rufen Sie ldap_parse_result auf, um die Ergebnisse zu analysieren. Verwenden Sie dann das Cookie, um ldap_create_page_control aufzurufen, um die nächste Seite der Ergebnisse abzurufen.

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

Siehe auch

Funktionen

ldap_create_page_control

ldap_parse_result

Freigeben über