VLSdisableAutoTimer
Syntax
LS_STATUS_CODE VLSdisableAutoTimer (
LS_HANDLE lshandle,
int state );
Argument | Description |
lshandle |
The handle returned by LSRequest or VLSrequestExt |
state |
VLS_ON or VLS_OFF |
NOTE VLS_OFF disables the auto timer and VLS_ON enables the auto timer.
Description
The automatic update process is timer-based on Windows and signal-based on UNIX. By default, it is enabled on both Windows and UNIX.
NOTE Since v9.2.0, the automatic update (using timers) is supported on Win32 console application as well.
Using the handle returned from requesting a license, a call to this function can be used to disable automatic renewal of one feature. Calling with an argument of zero handle disables auto renewal of all features.
NOTE On UNIX, call VLSdisableAutoTimer before using sleep or SIGALRM, or there could be a potential conflict with the timer signal. On Win32, call VLSdisableAutoTimer if thread has no message loop since the message loop is used to process the timer. If you disable the automatic timer, you must ensure that the license key is renewed periodically (before it expires) by calling LSUpdate.
Returns
The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:
Error Code |
Description |
VLS_CALLING_ERROR |
Invalid state. Needs to be either VLS_ON or VLS_OFF |
LS_BADHANDLE |
Invalid handle. |
For a complete list of the error codes, see Licensing Library Error and Result Codes.