ldap_parse_page_controlW-Funktion (winldap.h)

Die ldap_parse_page_control analysiert die Ergebnisse einer Suche in Seiten.

Syntax

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

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] ServerControls

Ein Array von Steuerelementen, die ein Seitensteuerelement enthalten. Das Seitensteuerelement enthält die Vom Server zurückgegebenen Cookie- und Gesamtzahlsfelder.

[out] TotalCount

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

[out] Cookie

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

Rückgabewert

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

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

Bemerkungen

Verwenden Sie ldap_parse_page_control in Verbindung mit ldap_create_page_control und ldap_parse_result, um die einfache Auslagerung von Ergebnissen mithilfe von Steuerelementen zu implementieren. Rufen Sie nach dem Aufrufen ldap_parse_page_control zum Abrufen der Serversteuerelemente und zum Extrahieren des Cookies aus dem Suchergebnis 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 mit Ergebnissen abzurufen.

Anmerkung

Der winldap.h-Header definiert ldap_parse_page_control als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	winldap.h
Library	Wldap32.lib
DLL-	Wldap32.dll

Siehe auch

Funktionen

ldap_create_page_control

ldap_parse_result