VLSgetDistbCrit

Syntax

int VLSgetDistbCrit (	 	 
char	 	*feature_name,
char	 	*feature_version,
char	 	*dist_crit,
int	 	distcrit_buflen ); 	 	 
Argument Description
feature_name

Name of the feature.

feature_version

Version of the feature. Must be unique.

dist_crit (OUT)

Dist_crit consists of the names of License Manager having licenses for the given feature_name and version. The dist_crit string must be null-terminated. An OUT parameter.

distcrit_buflen

Size of memory allocated for dist_crit.

Description

Returns the current token distribution status for the given license feature and version.

Returns

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

Error Codes

Description

VLS_CALLING_ERROR

>feature_name is NULL

>version is NULL

>dist_crit is NULL

>distcrit_buflen is zero or negative

>challenge argument is non-NULL, but cannot be understood.

>Using standalone library. This function cannot be used with standalone library. Also, both feature name and version cannot be NULL at the same time.

VLS_NO_SUCH_FEATURE

License Manager does not have a license that matches requested feature, version and capacity.

LS_BUFFER_TOO_SMALL

dist_crit buffer not large enough to store information.

VLS_NON_REDUNDANT_ SRVR

License Manager is non-redundant and therefore cannot support this redundancy-related operation.

VLS_FEATURE_INACTIVE

Feature is inactive on specified License Manager.

VLS_SERVER_SYNC_IN_ PROGRESS

License Manager synchronization in process.

VLS_NON_REDUNDANT_ FEATURE

Feature is non-redundant and thus cannot be used in this redundancy-related operation.

VLS_DIFF_LIB_VER

Version mismatch between License Manager API and client API.

VLS_VENDORIDMISMATCH

This error can occur under the following scenarios:

>The vendor of the requesting application does not match with the License vendor.

>The License addition failed due to mismatch among the vendor of the license and vendor of the isolated License Manager.

VLS_NO_SERVER_RUNNING

License Manager on specified host is not available for processing the license operation requests.

VLS_HOST_UNKNOWN

Invalid hostName is specified.

VLS_BAD_SERVER_ MESSAGE

Message returned by the License Manager could not be understood.

LS_NO_NETWORK

Generic error indicating that the network is unavailable in servicing license operation.

LS_NORESOURCES

An error occurred in attempting to allocate memory needed by this function.

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