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.
- 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.