ldap_get_paged_count-Funktion (winldap.h)

Die ldap_get_paged_count-Funktion zeichnet die Anzahl der ausgelagerten Ergebnisse auf, die der Server für eine Suche zurückgegeben hat.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_get_paged_count(
  [in]  PLDAP        ExternalHandle,
  [in]  PLDAPSearch  SearchBlock,
  [out] ULONG        *TotalCount,
  [out] PLDAPMessage Results
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] SearchBlock

Handle für eine LDAPSearch-Struktur .

[out] TotalCount

Die Gesamtzahl der Seiten in den Suchergebnissen.

[out] Results

Ein Zeiger auf die LDAPMessage-Struktur , die die Ergebnisse des Vorgangs enthält.

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 Rückgabewerte.

Hinweise

Rufen Sie ldap_get_paged_count für jedes Resultset auf, das nach dem Aufruf ldap_get_next_page empfangen wurde. Dadurch kann die LDAP-Runtime aus dem Cookie speichern, das der Server zum Nachverfolgen der Suche verwendet.

Wenn Sie ldap_get_next_page_s aufrufen, ist kein Aufruf von ldap_get_paged_count erforderlich.

Anforderungen

Siehe auch

Funktionen

LDAPMessage

LDAPSearch

Rückgabewerte

ldap_get_next_page

ldap_get_next_page_s