bind_s Function

This function performs complex authentication to the directory server.

Syntax

DBMS_LDAP.bind_s (    

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

RETURN PLS_INTEGER;

Parameters

Table 20-10 bind_s Function Parameters

Parameter	Description
ld	A valid LDAP session handle.
dn	The distinguished name of the user under which you are trying to login.
cred	A text string containing the credentials used for authentication.
meth	The authentication method.

Return Values

Table 20-11 bind_s Function Return Values

Value	Description
PLS_INTEGER	DBMS_LDAP.SUCCESS on a successful completion. One of the exceptions in Table 20-12 is raised if there is a problem.

Exceptions

Table 20-12 bind_s Function Exceptions

Exception	Description
invalid_session	Raised if the session handle ld is invalid.
invalid_auth_method	Raised if the authentication method requested is not supported.
mts_mode_not_supported	Raised if invoked from a user session that is logged onto 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.bind_s can be used to authenticate a user. It can be called only after a valid LDAP session handle is obtained from a call to DBMS_LDAP.init.

See Also: "init Function" "simple_bind_s Function"