populate_mod_array (String Version) Procedure

This procedure populates one set of attribute information for add or modify operations.

Syntax

DBMS_LDAP.populate_mod_array (

modptr  IN DBMS_LDAP.MOD_ARRAY,
mod_op  IN PLS_INTEGER,
mod_type  IN VARCHAR2,
modval  IN DBMS_LDAP.STRING_COLLECTION);

Parameters

Table 20-61 populate_mod_array (String Version) Procedure Parameters

Parameter	Description
modptr (IN)	The data structure holds a pointer to an LDAP mod array.
Mod_op (IN)	This field specifies the type of modification to perform.
Mod_type (IN)	This field indicates the name of the attribute type to which the modification applies.
Modval (IN)	This field specifies the attribute values to add, delete, or replace. It is for the string values only.

Return Values

Table 20-62 populate_mod_array (String Version) Procedure Return Values

Value	Description
N/A

Exceptions

Table 20-63 populate_mod_array (String Version) Procedure Exceptions

Exception	Description
invalid_mod_array	Invalid LDAP mod array.
invalid_mod_option	Invalid LDAP mod option.
invalid_mod_type	Invalid LDAP mod type.
invalid_mod_value	Invalid LDAP mod value.

Usage Notes

This function is one of the preparation steps for DBMS_LDAP.add_s and DBMS_LDAP.modify_s. It has to happen after DBMS_LDAP.create_mod_array is called.

See Also: "create_mod_array Function" "modify_s Function" "add_s Function" "free_mod_array Procedure"