delete_s Function

This function removes a leaf entry in the LDAP Directory Information Tree.

Syntax

DBMS_LDAP.delete_s (

ld  IN SESSION,
entrydn  IN VARCHAR2)

RETURN PLS_INTEGER;

Table 20-49 delete_s Function Parameters

Parameter Name	Description
ld (IN)	A valid LDAP session
entrydn (IN)	The X.500 distinguished name of the entry to delete.

Return Values

Table 20-50 delete_s Function Return Values

Value	Description
PLS_INTEGER	DBMS_LDAP.SUCCESS if the delete operation wa successful. An exception is raised otherwise.

Exceptions

Table 20-51 delete_s Function Exceptions

Exception	Description
invalid_session	Raised if the session handle ld is invalid.
invalid_entry_dn	Raised if the distinguished name of the entry is invalid
general_error	For all other errors. The error string associated with this exception explains the error in detail.

Usage Notes

The function delete_s can be used to remove only leaf level entries in the LDAP DIT. A leaf level entry is an entry that does not have any children/LDAP entries under it. It cannot be used to delete non-leaf entries.

See Also: "modrdn2_s Function".