4.6 WFS_CMD_TTU_DISPLAY_FORM

Description This command is used to display a form by merging the supplied variable field data with the defined form and field data specified in the form.

Input Param LPWFSTTUDISPLAYFORM lpDisplayform;

typedef struct _wfs_ttu_display_form
{
LPSTR lpszFormName;
BOOL bClearScreen;
LPSTR lpszFields;
} WFSTTUDISPLAYFORM, * LPWFSTTUDISPLAYFORM;

lpszFormName
Pointer to the null-terminated form name.

bClearScreen
Specifies whether the screen is cleared before displaying the form (TRUE) or not (FALSE).

lpszFields
Pointer to a series of "<FieldName>=<FieldValue>" strings, where each string is null-terminated with the final string terminating with two null characters.

Output Param None.

Error Codes The following additional error codes can be generated by this command:

Value Meaning

WFS_ERR_TTU_FORMNOTFOUND The specified form definition cannot be found.

WFS_ERR_TTU_FORMINVALID The specified form definition is invalid.

WFS_ERR_TTU_MEDIAOVERFLOW The form overflowed the media.

WFS_ERR_TTU_FIELDSPECFAILURE The syntax of the lpszFields member is invalid.

WFS_ERR_TTU_FIELDERROR An error occurred while processing a field, causing termination of the display request

Events There are no additional events generated by this command.

Comments None.