Skip Headers

Oracle9i Supplied PL/SQL Packages and Types Reference
Release 2 (9.2)

Part Number A96612-01
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback

Go to previous page Go to next page

21
DBMS_LDAP

DBMS_LDAP provides functions and procedures to access data from LDAP servers. To use DBMS_LDAP, you must first load it into the database. Use the catldap.sql script located in the $ORACLE_HOME/rdbms/admin directory.

See Also:

Oracle Internet Directory Application Developer's Guide for more information on using DBMS_LDAP.

This chapter discusses the following topics:

Exception Summary

Table 21-1 lists the exceptions generated by DBMS_LDAP.

Table 21-1 DBMS_LDAP Exception Summary
Exception Name Oracle Error Cause of Exception

general_error

31202

Raised anytime an error is encountered that does not have a specific PL/SQL exception associated with it. The error string contains the description of the problem in the local language of the user.

init_failed

31203

Raised by DBMS_LDAP.init if there are some problems.

invalid_session

31204

Raised by all functions and procedures in the DBMS_LDAP package if they are passed an invalid session handle.

invalid_auth_method

31205

Raised by DBMS_LDAP.bind_s if the authentication method requested is not supported.

invalid_search_scope

31206

Raised by all of the search functions if the scope of the search is invalid.

invalid_search_time_val

31207

Raised by time based search function: DBMS_LDAP.search_st if it is given an invalid value for the time limit.

invalid_message

31208

Raised by all functions that iterate through a result-set for getting entries from a search operation if the message handle given to them is invalid.

count_entry_error

31209

Raised by DBMS_LDAP.count_entries if it cannot count the entries in a given result set.

get_dn_error

31210

Raised by DBMS_LDAP.get_dn if the DN of the entry it is retrieving is NULL.

invalid_entry_dn

31211

Raised by all the functions that modify/add/rename an entry if they are presented with an invalid entry DN.

invalid_mod_array

31212

Raised by all functions that take a modification array as an argument if they are given an invalid modification array.

invalid_mod_option

31213

Raised by DBMS_LDAP.populate_mod_array if the modification option given is anything other than MOD_ADD, MOD_DELETE or MOD_REPLACE.

invalid_mod_type

31214

Raised by DBMS_LDAP.populate_mod_array if the attribute type that is being modified is NULL.

invalid_mod_value

31215

Raised by DBMS_LDAP.populate_mod_array if the modification value parameter for a given attribute is NULL.

invalid_rdn

31216

Raised by all functions and procedures that expect a valid RDN if the value of the RDN is NULL.

invalid_newparent

31217

Raised by DBMS_LDAP.rename_s if the new parent of an entry being renamed is NULL.

invalid_deleteoldrdn

31218

Raised by DBMS_LDAP.rename_s if the deleteoldrdn parameter is invalid.

invalid_notypes

31219

Raised by DBMS_LDAP.explode_dn if the notypes parameter is invalid.

invalid_ssl_wallet_loc

31220

Raised by DBMS_LDAP.open_ssl if the wallet location is NULL but the SSL authentication mode requires a valid wallet.

invalid_ssl_wallet_password

31221

Raised by DBMS_LDAP.open_ssl if the wallet password given is NULL.

invalid_ssl_auth_mode

31222

Raised by DBMS_LDAP.open_ssl if the SSL authentication mode is not one of 1, 2, or 3.

mts_mode_not_supported

31398

Raised by the functions init, bind_s or simple_bind_s if they are ever invoked in MTS mode.

Summary of Data Types

The DBMS_LDAP package uses the data types shown in Table 21-2.

Table 21-2 DBMS_LDAP Summary of Data Types
Data-Type Purpose

SESSION

Holds the handle of the LDAP session. Nearly all of the functions in the API require a valid LDAP session to work.

MESSAGE

Holds a handle to the message retrieved from the result set. This is used by all functions that work with entries, attributes, and values.

MOD_ARRAY

Holds a handle into the array of modifications being passed into either modify_s or add_s.

TIMEVAL

Passes time limit information to the LDAP API functions that require a time limit.

BER_ELEMENT

Holds a handle to a BER structure used for decoding incoming messages.

STRING_COLLECTION

Holds a list of VARCHAR2 strings which can be passed on to the LDAP server.

BINVAL_COLLECTION

Holds a list of RAW data which represent binary data.

BERVAL_COLLECTION

Holds a list of BERVAL values that are used for populating a modification array.


Go to previous page Go to next page
Oracle
Copyright © 2000, 2002 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback