LSAPI Constants

Notice:This is preliminary documentation for technology that will be supported in future releases of Microsoft Windows.

This section describes the standard LSAPI C constants. They are listed in alphabetic order.

Constant/Value Type Meaning
LS_ANY

null string

LS_STR FAR * Indicates that all license system providers should be searched for a license match.
LS_BASIC_PROTOCOL

0x00000001

LS_ULONG Specifies the basic challenge protocol that is supported by all LSAPI-compliant license systems.
LS_DEFAULT_UNITS

0xFFFFFFFF

LS_ULONG Indicates that the license system and the associated license policy should determine the number of license units.
LS_INFO_DATA

2

LS_ULONG Returns a vendor-defined block of data contained on the license. The first ULONG value in this data buffer indicates the size, in bytes, of the data following it. The space allocated for this data can vary on each license system, or might not be available at all.
LS_INFO_NONE

0

LS_ULONG Reserved.
LS_INFO_SYSTEM

1

LS_ULONG Returns the unique identification of the license system supplying the current license context. The value is a null-terminated string, and it is the same as that returned by a call to the LSEnumProviders function.
LS_LICENSE_CONTEXT

4

LS_ULONG Returns a value that uniquely identifies the license context within the specific license service provider identified by the LicenseHandle parameter. The bytes returned are specific to the license system. When license-system - specific functionality is being used, you can use this sequence of bytes to identify the current license context.
LS_MAX_PROVIDER _NAME

255

LS_ULONG Specifies the maximum length of a provider name that the LSEnumProviders function returns.
LS_NO _RECOMMENDATION

0xFFFFFFFF

LS_ULONG Indicates that the license system cannot supply an interval recommendation when a call to the LSQuery function using LS_UPDATE_PERIOD returns this value.
LS_NULL

NULL

LS_VOID FAR * Specifies a null value for all optional pointer arguments. LS_NULL must be used to indicate the absence of a value.
LS_OUT_OF_BAND _PROTOCOL

0xFFFFFFFF

LS_ULONG Specifies an out-of-band challenge/response protocol, one that is available to an application by means external to the LSAPI.
LS_UPDATE_PERIOD

3

LS_ULONG Returns the recommended interval, in minutes, at which an application should call the LSUpdate function. If a value of 0xFFFFFFFF is returned, the license system cannot supply a recommendation.
LS_USE_LAST

0x0800FFFF

LS_ULONG Indicates that the LSGetMessage function should use as input the last status value returned for the current process.