Oracle9i Supplied PL/SQL Packages and Types Reference
Release 1 (9.0.1)

Part Number A89852-02
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 beginning of chapter Go to next page

DBMS_LDAP , 24 of 30


add_s Function

This function adds a new entry to the LDAP directory sychronously. Before calling add_s, you must call DBMS_LDAP.create_mod_array and DBMS_LDAP.populate_mod_array.

Syntax

DBMS_LDAP.add_s (

ld  IN DBMS_LDAP.SESSION,
entrydn  IN VARCHAR2,
modptr  IN DBMS_LDAP.MOD_ARRAY)
RETURN PLS_INTEGER;

Parameters
Table 20-70 add_s Function Parameters
Parameter  Description 

ld (IN) 

A handle to an LDAP session, as returned by a successful call to DBMS_LDAP.init. 

Entrydn (IN) 

Specifies the name of the directory entry to be created. 

Modptr (IN) 

The handle to an LDAP mod structure, as returned by successful call to DBMS_LDAP.create_mod_array. 

Return Values
Table 20-71 add_s Function Return Values
Value  Description 

PLS_INTEGER 

The indication of the success or failure of the modification operation. 

Exceptions
Table 20-72 add_s Function Exceptions
Exception  Description 

invalid_session 

Invalid LDAP session. 

invalid_entry_dn 

Invalid LDAP entry dn. 

invalid_mod_array 

Invalid LDAP mod array. 

Usage Notes

The parent entry of the entry to be added must already exist in the directory. This function call has to follow successful calls of DBMS_LDAP.create_mod_array and DBMS_LDAP.populate_mod_array.

See Also:

 

Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 1996-2001, 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