This function retrieves how many "allowable days" are remaining. (i.e. how many more days the application can be used)
[C++Builder/Visual C++] long
PK3QueryRemainDays(void);
[Delphi] function
PK3QueryRemainDays: Longint;
[Visual Basic] Function
PK3QueryRemainDays() As Long
Parameters
None
Return Value
| Value | Explanation |
| The number of allowable days remaining | This return value is possible when the PK3QueryProtect function returns 0 (which means the application is still allowed to run) and the remaining allowable days is non-zero. |
| A negative value other than -1 (i.e. -3) | This return value is possible when the PK3QueryProtect function returns 3, 4, or 5 (which means the remaining allowable days, remaining allowable months, or protection date has been exceeded). In this case the negative number is the number of days exceeded. (i.e. A return value of -3 means that 3 days have elasped since the remaining allowable days, remaining allowable months, or the protection date was exceeded.) |
| -1 | This return value is possible when the PK3QueryProtect function returns 1 (which
means the application is currently locked); or when a restricted
password has been set and the remaining allowable days, remaining
allowable months, or protection date have been exceeded. This return value is also possible when the PK3QueryProtect function returns any values other than 0, 1, 3, 4 or 5. |
Explanation
The PK3QueryRemainDays function retrieves how many "allowable days" are remaining. (i.e. how many more days the application can be used). This function will only return the "remaining allowable days" when the type of protection that has been applied is "number of days", "number of months", or "date". If other types of protection are used or if the application software has been unlocked without other restrictions, the PK3QueryRemainDays function will return -1.
The PK3QueryRemainDays function is disabled if the PK3Initialize function has not been executed.