Copyright © Cloud Software Group, Inc. All Rights Reserved

openform_get_field_value()

Get the value for an iProcess field in the given form session.

Synopsis

C/C++

long int openform_get_field_value (long int openform_id, long int sal_formsh, LPSTR lpfield_name, LPSTR lpfield_value)

VB

Function openform_get_field_value (openform_id As Long, sal_formsh As Long, lpfield_name As String, lpfield_value As String) 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.

•	lpfield_name is the name of the iProcess field you want to get the value of.

•	lpfield_value is a pointer to buffer space where the field value should be returned. This should be large enough to contain the maximum number of characters in the field, plus 1 byte for a NULL terminator.

Description

Use this function to obtain the value for an iProcess field from a work item’s form data.

Returns

One of the following numeric values.

Value	Description
1	Success. The field value is returned in lpfield_value.
0	Invalid openform_id.
-1	Invalid sal_formsh.
-2	Invalid lpfield_name.
-3	Invalid lpfield_value.
-4	np_sal_frm_getdata() interface function not available.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved