LSEnumProviders(3nw)
LSEnumProviders --
returns a unique string containing the name of any accessible licensing system
Synopsis
LS_STATUS_CODE LSEnumProviders(
LS_ULONG index,
LS_STR
buffer);
Description
The parameters are as follows:
- index
-
(IN) Specifies an index for all installed licensing systems (zero for the first licensing system, 1 for the second, and so on). index should be incremented by the
caller for each successive call to LSEnumProviders until LS_BAD_INDEX is returned.
- buffer
-
(OUT) Points to the buffer where the unique NULL-terminated string identifying the licensing system will be placed. This buffer must be at least 255 bytes.
Return values
This function returns a detailed error code that can be directly processed by the caller, or that can be converted by LSGetMessage to one of these message strings:
- LS_SUCCESS
-
The requested functionality completed successfully.
- LS_SYSTEM_UNAVAILABLE
-
DOS TSR or Windows DLL is not properly configured or available, or client has no licensing system to communicate with.
- LS_RESOURCES_UNAVAILABLE
-
Insufficient resources (such as memory) available to complete request.
- LS_BAD_ARG
-
One or more parameters are invalid.
Notices
An application can enumerate the installed licensing systems by calling LSEnumProviders successively. The string returned by LSEnumProviders is the same as
that returned by calling LSQuery with information set to LS_INFO_SYSTEM.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.