create_mod_array Function

This function allocates memory for array modification entries that are applied to an entry using the modify_s or add_s functions.

Syntax

DBMS_LDAP.create_mod_array (

num  IN PLS_INTEGER)

RETURN MOD_ARRAY;

Parameters

Table 20-58 create_mod_array Function Parameters

Parameter	Description
num (IN)	The number of the attributes that you want to add or modify.

Return Values

Table 20-59 create_mod_array Function Return Values

Value	Description
MOD_ARRAY	The data structure holds a pointer to an LDAP mod array. NULL if there was a problem.

Exceptions

Table 20-60 create_mod_array Function Exceptions

Exception	Description
N/A	No LDAP specific exception is raised

Usage Notes

This function is one of the preparation steps for DBMS_LDAP.add_s and DBMS_LDAP.modify_s. It is required to call DBMS_LDAP.free_mod_array to free memory after the calls to add_s or modify_s have completed.

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