3.4 WFS_INF_IDC_QUERY_FORM

Description This command is used to retrieve details of the definition of a specified form.

Input Param LPSTR lpszFormName;

lpszFormName
Points to the null-terminated form name on which to retrieve details.

Output Param LPWFSIDCFORM lpForm;

typedef struct _wfs_idc_form
{
LPSTR lpszFormName;
char cFieldSeparatorTrack1;
char cFieldSeparatorTrack2;
char cFieldSeparatorTrack3;
WORD fwAction;
LPSTR lpszTracks;
BOOL bSecure;
LPSTR lpszTrack1Fields;
LPSTR lpszTrack2Fields;
LPSTR lpszTrack3Fields;
} WFSIDCFORM, * LPWFSIDCFORM;

lpszFormName
Specifies the null-terminated name of the form.

cFieldSeparatorTrack1
Specifies the value of the field separator of Track 1.

cFieldSeparatorTrack2
Specifies the value of the field separator of Track 2.

cFieldSeparatorTrack3
Specifies the value of the field separator of Track 3.

fwAction
is a flag word that specifies the form action; can be one of the following:

Value Meaning

WFS_IDC_ACTIONREAD The form reads the card.

WFS_IDC_ACTIONWRITE The form writes the card.

lpszTracks
Specifies the read algorithm or the track to write.

bSecure
Specifies whether or not to do a security check.

lpszTrack1Fields
Pointer to a list of null-terminated field names of Track 1, with the final name terminating with two null characters.

lpszTrack2Fields
Pointer to a list of null-terminated field names of Track 2, with the final name terminating with two null characters.

lpszTrack3Fields
Pointer to a list of null-terminated field names of Track 3, with the final name terminating with two null characters.

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

Value Meaning

WFS_ERR_IDC_FORMNOTFOUND The specified form cannot be found.

WFS_ERR_IDC_FORMINVALID The specified form is invalid.

Comments None.