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