Copyright © Cloud Software Group, Inc. All Rights Reserved

openform_keep()

Keep the work item associated with the given form session.

Synopsis

C/C++

long int openform_keep (long int openform_id, long int sal_formsh)

VB

Function openform_keep (openform_id As Long, sal_formsh As Long) As Long

where:

•	openform_id is the identifier of the Open Forms SDK Interface Function module, as returned by openform_initialise().

•	sal_formsh is the SAL form session handle that identifies the work item, as passed to your Open Form application by the calling script. See Creating the Script to Call the Open Forms Application.

Description

Use this function when you want to keep a work item (return it to the user’s queue).

You must not use the Returns, openform_set_field_value() or openform_release() functions after using this function, because the sal_formsh will no longer be valid.

Returns

One of the following numeric values.

Value	Description
1	Success.
0	Invalid openform_id.
-1	Invalid sal_formsh.
-4	np_sal_frm_getdata() interface function not available.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved