modify_s Function

This function performs a synchronous modification of an existing LDAP directory entry.

Syntax

DBMS_LDAP.modify_s (

ld  IN DBMS_LDAP.SESSION,
entrydn  IN VARCHAR2,
modptr  IN DBMS_LDAP.MOD_ARRAY)

RETURN PLS_INTEGER;

Parameters

Table 20-67 modify_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 whose contents are to be modified.
modptr (IN)	The handle to an LDAP mod structure, as returned by a successful call to DBMS_LDAP.create_mod_array.

Return Values

Table 20-68 modify_s Function Return Values

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

Exceptions

Table 20-69 modify_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

This function call has to follow successful calls of DBMS_LDAP.create_mod_array and DBMS_LDAP.populate_mod_array.

See Also: "create_mod_array Function" "populate_mod_array (String Version) Procedure" "add_s Function" "free_mod_array Procedure"