VLSgetFeatureInfoExt

Syntax

LS_STATUS_CODE VLSgetFeatureInfoExt (	 	 
unsigned char		*feature_name,
unsigned char		*version,
unsigned long		*capacity,
int	 	 	index,
char	 		*unused1,
unsigned long	 	*unused2,
VLSfeatureInfo  *feature_info );

Argument	Description
feature_name	Name of the feature.
version	Version of the feature.
capacity	Capacity of the feature.
index	Used to specify a particular feature.
unused1	Use NULL as value.
unused2	Use 0 as value.
feature_info	The structure in which information will be returned. Space must be allocated by caller.

Description

Returns the information of features available on the License Manager.

>If name, version and capacity is not NULL, information about the feature indicated by name, version and capacity is returned.

>If information about a non-capacity license is desired, capacity should be passed as NULL and feature must be non-NULL.

>If information about all licensed features (capacity as well as non-capacity) is desired, feature name should be NULL, and index should be used in a loop.

Returns

The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:

Error Code	Description
VLS_CALLING_ERROR	>featureinfo is NULL >index is negative >Attempted to use standalone mode with network-only library, or network mode with standalone library.
VLS_APP_UNNAMED	Version is NULL when name is non_NULL
VLS_NO_MORE_ FEATURES	Finished retrieving feature information for all features on License Manager.
VLS_NO_SERVER_ RUNNING	License Manager on specified host is not available for processing license operation requests.
VLS_NO_SERVER_ RESPONSE	Communication with License Manager has timed out.
VLS_HOST_UNKNOWN	Invalid hostName was specified.
VLS_NO_SERVER_FILE	No License Manager has been set and unable to determine which License Manager to use.
VLS_BAD_SERVER_ MESSAGE	Message from License Manager could not be understood.
LS_NO_NETWORK	Generic error indicating that the network is unavailable for servicing the license operation.
LS_NORESOURCES	An error occurred in attempting to allocate memory needed by function.
VLS_NO_SUCH_ FEATURE	License Manager does not have license that matches requested feature, version and capacity.

For a complete list of the error codes, see Licensing Library Error and Result Codes.