A script-enabled browser is required for this page to function properly.

Invoking a Foreign Function from a User Exit

After creating a user exit to a foreign function, invoke the foreign function using a user exit interface from Oracle Forms. To invoke a foreign function from a user exit, call the USER_EXIT Built-in subprogram from a trigger or from a user-named subprogram.

When you invoke a foreign function from a user exit, Oracle Forms temporarily passes processing control to the foreign function. When execution of the foreign function is complete, Oracle Forms regains processing control.

Syntax

USER_EXIT(user_exit_string);

USER_EXIT(user_exit_string, error_string);

The USER_EXIT Built-in calls the foreign function named in the user_exit_string.

Parameters

user_exit_string

Specifies a user exit name for a foreign function to call from a user exit, including any parameters. Maximum length of the user_exit_string is 255 characters.

error_string 

Specifies a user-defined error message that Oracle Forms displays if the call to the foreign function fails. Maximum length of the error_string is 255 characters.

Invoking a foreign function from a user exit Restrictions

The user exit name that represents a foreign function (in the user_exit_string of the USER_EXIT Built-in subprogram) must follow the rules of your operating system and host language. Be aware that these rules might include case sensitivity. Also note that only one foreign function can be invoked per USER_EXIT Built-in call.


Passing parameter values to a foreign function using USER_EXIT

Returning a value from a foreign function using USER_EXIT