DDAP gate, START_BROWSE_RESULTS function

The START_BROWSE_RESULTS function of the DDAP gate allows you to browse the results (attributes or entries) returned by the SEARCH_LDAP call.

Input Parameters

DISTINGUISHED_NAME
Optional parameter
indicates the buffer where you want the distinguished name of the first, or only located result returned. A group of three fullwords are specified for the buffer-descriptor:
  • The address where the data is returned.
  • The length of the buffer in bytes, where the data is returned.
  • The maximum length in bytes of the data. This can be specified as *, and the length is then returned in DDAP_DISTINGUISHED_NAME_N.
For more information on buffer-descriptors, see XPI syntax.
SEARCH_TOKEN
the name of the fullword token that is returned by the SEARCH_LDAP function.

Output Parameters

REASON
The following values are returned when RESPONSE is EXCEPTION:
  • INVALID_TOKEN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
ENTRY_COUNT
Optional parameter
a fullword indicating the number of attributes that can be browsed in the current entry.
LDAP_RESPONSE
Optional parameter
specifies the return code that is sent by the LDAP API.


dfhs3_DDAPstart_browse_results.html | Timestamp icon Last updated: Monday, 5 June 2017