VISUAL PAYMENTS
fnDownReq()
262 M
X
800 SERIES PROGRAMMERS GUIDE
fnDownReq()
Called after a REQ packet is received on the Down Channel. The application can:
• allow or disallow this command to proceed
• perform the request and detail the result.
If this callback function is not provided, all REQ commands will be allowed to run.
VP library will send the ACK prior to issuing this callback.
Prototype
int fnDownReq(int iDownFd, int iFieldCount, vp_field_t *pszFields);
typedef struct
{
char key[MAX_KEY_SIZE];
char value[MAX_VALUE_SIZE];
} vp_field_t;
Parameters
Return Values
NOTE
System mode may use this to put up downloading status.
iDownFd Socket fd of Down Channel.
iFieldCount Number of fields in the array.
pszFields Pointer to array of field structure.
> 0 Allow
0 Success, application performed the request
-1 Disallow, and don’t ask again
-2 Disallow, terminal busy, try again
-3 Failure, application performed the request
-4 Failure