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.