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.