populate_mod_array (Binary Version) Procedure

This procedure populates one set of attribute information for add or modify operations. This procedure call has to happen after DBMS_LDAP.create_mod_array is called.

Syntax

PROCEDURE populate_mod_array
    (modptr   IN DBMS_LDAP.MOD_ARRAY,
     mod_op   IN PLS_INTEGER,
     mod_type IN VARCHAR2,
     modval   IN DBMS_LDAP.BERVAL_COLLECTION);

Parameters

Table 20-64 populate_mod_array (Binary 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_typ (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 binary values.

Return Values

Table 20-65 populate_mod_array (Binary Version) Procedure Return Values

Value	Description
N/A

Exceptions

Table 20-66 populate_mod_array (Binary 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"