get_values_len Function

This function retrieves values of attributes that have a Binary syntax.

Syntax

DBMS_LDAP.get_values_len (    

ld  IN SESSION,
ldapentry  IN MESSAGE,
attr  IN VARCHAR2)

RETURN BINVAL_COLLECTION;

Parameters

Table 20-46 get_values_len Function Parameters

Parameter	Description
ld (IN)	A valid LDAP session handle.
ldapentrymsg (IN)	A valid handle to an entry returned from a search result.
attr (IN)	The string name of the attribute for which values are being sought.

Return Values

Table 20-47 get_values_len Function Return Values

Value	Description
BINVAL_COLLECTION	A PL/SQL Raw collection containing all the values of the given attribute. NULL if there are no values associated with the given attribute.

Exceptions

Table 20-48 get_values_len Function Exceptions

Exception	Description
invalid_session	Raised if the session handle ld is invalid.
invalid_message	Raised if the incoming entry handle is invalid

Usage Notes

The function get_values_len can only be called after the handle to entry has been retrieved by a call to either first_entry or next_entry. The name of the attribute can be known beforehand, and it can also be determined by a call to first_attribute or next_attribute. This function can be used to retrieve both binary and non-binary attribute values.

See Also: "first_entry Function" "next_entry Function" "get_values Function" "count_values_len Function"