get_dn Function

This function retrieves the X.500 distinguished name of a given entry in the result set.

The function first_attribute fetches the first attribute of a given entry in the result set

Syntax

DBMS_LDAP.get_dn (

ld  IN SESSION,
msg  IN MESSAGE)

RETURN VARCHAR2;

Parameters

Table 20-40 get_dn Function Parameters

Parameter	Description
ld (IN)	A valid LDAP session handle.
msg (IN)	The entry whose DN is to be returned.

Return Values

Table 20-41 get_dn Function Return Values

Value	Description
VARCHAR2	The X.500 distinguished name of the entry as a PL/SQL string. NULL if there was a problem.

Exceptions

Table 20-42 get_dn Function Exceptions

Exception	Description
invalid_session	Raised if the session handle ld is invalid.
invalid_message	Raised if the incoming msg handle is invalid.
get_dn_error	Raised if there was a problem in determining the DN.

Usage Notes

The function get_dn can be used to retrieve the DN of an entry as the program logic is iterating through the result set. This be used as an input to explode_dn to retrieve the individual components of the DN.

See Also: "explode_dn Function".