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 , 28 of 30


rename_s Function

This function renames an LDAP entry synchronously.

Syntax

DBMS_LDAP.rename_s (

ld  IN SESSION,
dn  IN VARCHAR2,
newrdn  IN VARCHAR2,
newparent  IN VARCHAR2,
deleteoldrdn  IN PLS_INTEGER,
serverctrls  IN LDAPCONTROL,
clientctrls  IN LDAPCONTROL)
RETURN PLS_INTEGER;

Parameters
Table 20-82 rename_s Function Parameters
Parameter  Description 

ld (IN) 

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

Dn (IN) 

Specifies the name of the directory entry to be renamed or moved. 

newrdn (IN) 

Specifies the new RDN. 

Newparent (IN) 

Specifies the DN of the new parent. 

Deleteoldrdn (IN) 

Specifies if the old RDN should be retained. If this value is 1, then the old RDN is removed. 

Serverctrls (IN) 

Currently not supported. 

Clientctrls (IN) 

Currently not supported. 

Return Values
Table 20-83 rename_s Function Return Values
Value  Description 

PLS_INTEGER 

The indication of the success or failure of the operation. 

Exceptions
Table 20-84 rename_s Function Exceptions
Exception  Description 

invalid_session 

Invalid LDAP Session. 

invalid_entry_dn 

Invalid LDAP DN. 

invalid_rdn 

Invalid LDAP RDN. 

invalid_newparent 

Invalid LDAP newparent. 

invalid_deleteoldrdn 

Invalid LDAP deleteoldrdn. 

See Also:

"modrdn2_s Function"


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