open_ssl Function

This function establishes an SSL (Secure Sockets Layer) connection over an existing LDAP connection.

Syntax

DBMS_LDAP.open_ssl (

ld  IN SESSION,
sslwrl  IN VARCHAR2,
sslwalletpasswd  IN VARCHAR2,
sslauth  IN PLS_INTEGER)

RETURN PLS_INTEGER;

Parameters

Table 20-88 open_ssl Function Parameters

Parameter	Description
ld (IN)	A handle to an LDAP session, as returned by a successful call to DBMS_LDAP.init.
Sslwrl (IN)	Specifies the wallet location (Required for one-way or two-way SSL connection.)
sslwalletpasswd (IN)	Specifies the wallet password (Required for one-way or two-way SSL connection.)
sslauth (IN)	Specifies the SSL Authentication Mode (1 for no authentication required, 2 for one way authentication required, 3 for two way authentication required.

Return Values

Table 20-89 open_ssl Function Return Values

Value	Description
PLS_INTEGER	The indication of the success or failure of the operation.

Exceptions

Table 20-90 open_ssl Function Exceptions

Exception	Description
invalid_session	Invalid LDAP Session.
invalid_ssl_wallet_loc	Invalid LDAP SSL wallet location.
invalid_ssl_wallet_passwd	Invalid LDAP SSL wallet passwd.
invalid_ssl_auth_mode	Invalid LDAP SSL authentication mode.

Usage Notes

Call DBMS_LDAP.init first to acquire a valid LDAP session.

See Also: "init Function".