simple_bind_s Function

This function can be used to perform simple username/password based authentication to the directory server.

Syntax

DBMS_LDAP.simple_bind_s (    

ld  IN SESSION,
dn  IN VARCHAR2,
passwd  IN VARCHAR2)

RETURN PLS_INTEGER;

Parameters

Table 20-7 simple_bind_s Function Parameters

Parameter	Description
ld (IN)	A valid LDAP session handle.
dn (IN)	The distinguished name of the user under which you are trying to login.
passwd (IN)	A text string containing the password.

Return Values

Table 20-8 simple_bind_s Function Return Values

Value	Description
PLS_INTEGER	DBMS_LDAP SUCCESS on a successful completion. If there was a problem, one of the exceptions in Table 20-9 is raised.

Exceptions

Table 20-9 simple_bind_s Function Exceptions

Exception	Description
invalid_session	Raised if the session handle ld is invalid.
mts_mode_not_supported	Raised if DBMS_LDAP.init is invoked from a user session that is logged onto as an MTS service.
general_error	For all other errors. The error string associated with this exception explains the error in detail.

Usage Notes

DBMS_LDAP.simple_bind_s can be used to authenticate a user whose directory distinguished name and directory password are known. It can be called only after a valid LDAP session handle is obtained from a call to DBMS_LDAP.init.