DDAP gate, GET_NEXT_ATTRIBUTE function

The GET_NEXT_ATTRIBUTE function of the DDAP gate allows you to get the next attribute in a series, from an entry returned by the SEARCH_LDAP call.

Input Parameters

LDAP_ATTRIBUTE_NAME
indicates the buffer where you want the attribute name returned. A group of three fullwords are specified for the buffer-descriptor:
  • The address where the data is returned.
  • The maximum size in bytes, of the data returned.
  • The actual length in bytes of the data. This can be specified as *, and the length is then returned in DDAP_LDAP_ATTRIBUTE_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:
  • BROWSE_END
  • INVALID_TOKEN
  • NOT_FOUND
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
LDAP_RESPONSE
Optional parameter
specifies the return code that is sent by the LDAP API.
VALUE_COUNT
Optional parameter
a fullword containing the number of values returned for this attribute. There is usually one value returned.


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