LePinBlock function direct

This function is called directly by the “Commercial Automation” application to carry out the collecting the password from the holder of a proprietary card (from the commercial establishment itself).

int LePinblockDireto (int iModoCripto, char *lpcCard, char *lpcTuiccs, int iTimeout, char *lpcParamAdic,
short (CALLBACK *pTstCancela) (void), char *lpcExit, int iTamMsg, char *lpcMsg)
void LePinblockDiretoA (char *lpcResult, char *lpcCriptoMode, char *lpcCard, char *lpcTuiccs,
char *lpcTimeout, char *lpcParamAdic, char *lpcOutput, char *lpcTamMsg, char *lpcMsg)

Parameter	Type	Standard interface	ASCII Interface	Description
lpcResult	Output	Not used	Fixed 6 bytes	Contains the result of the response to the routine call
lpcCard	Entry	char *(null-terminated)	Variable (must be passed between delimiters: `{}, [], (), or <>)`	Card identification from 6 to 19 digits. Track 1 or track 2 of the card is also accepted.
lpcTuiccs	Input	char * (null-terminated)	Variable (must be passed between delimiters: `{}, [], (), or <>)`	Unique token for customer identification when collecting password. This buffer, provided by Software Express, must be informed as a parameter of this function by “Commercial Automation”. Indicates the mode chosen for password collection: “OFF-Line” or “ON-Line”. For each collection mode there is a specific TUICCS.
Timeout	Input	int	Fixed 3 bytes	Waiting time, in seconds, for entering the password. If the value 0 is passed, a default value of 30 seconds will be used.
lpcParamAdic	Entrance	char * (null terminated)	Variable (must be passed between delimiters: `{}, [], (), or <>)` )	Minimum and maximum password length in the format: `{ColetaSenhaTamMin=4;ColetaSenhaTamMax=12}` Where ColetaSenhaTamMin is the minimum length of the password and ColetaPasswordSizeMax is the maximum size. If null or an empty string is passed, the sizes will assume the default values of 4 for the minimum size and 12 for the maximum. If the minimum size is less than 4, the minimum size considered will be 4. If the maximum size is greater than 12, the maximum size considered will be 12.
pTstCancel	Entrance	Function *	Not used	Callback routine for the “Commercial Automation” application. Allows the “Operator” to cancel entering the password. If it returns: “0” - Indicates to CliSiTef that you want to continue waiting for the password to be entered. “1” - Indicates that the “Operator” wants to cancel the password entry. Optional parameter. The automation must pass NULL in this parameter if you do not want password collection to be canceled by the “Operator”.
lpcExit	Output	char * (null-terminated)	Fixed 16 bytes	Returns a pinblock of the encrypted password
lpcTamMsg	Input	Int	Fixed 6 bytes	Indicates maximum size of the “lpcMsg” field for message return in the password collection process. Minimum value is 2, but a value of 128 bytes is recommended. Messages larger than the specified size will be truncated.
lpcMsg	Output	char * (null-terminated)	Fixed ‘lpcTamMsg’ bytes	Returns informational message about the pinblock collection process. The maximum message size is indicated in lpcTamMsg. In case of an error, it will bring a message detailing the error that occurred. If successful, it will indicate the pinblock capture mode, which will be informed in TLV format: `0010011 – pinblock collected with DES key` ` ``0010012 – pinblock collected with 3DES key ```

Home