VLSgetDistbCritToFile
Syntax
int VLSgetDistbCritToFile (
char *feature_name,
char *feature_version,
char *file_name ); | Argument | Description |
|
feature_name |
Name of the feature. |
|
feature_version |
Version of the feature. |
|
file_name |
License Manager will write distribution criteria for the specified feature or version to the file. |
Description
Requests the License Manager provide current token distribution status for the given license feature and version, or for all features, or for all versions, or for all features and all versions (wild card characters are acceptable).
Returns
The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:
|
Error Code |
Description |
|
VLS_CALLING_ERROR |
>feature_name is NULL >file_name is NULL. >Using standalone library. This function cannot be used with standalone library. |
|
VLS_NO_SUCH_FEATURE |
License Manager does not have a license that matches the requested feature, version and capacity. |
|
VLS_FILE_OPEN_ERROR |
An error occurred while opening the file. |
|
VLS_NON_REDUNDANT_ SRVR |
License Manager is non-redundant and therefore cannot support this redundancy-related operation. |
|
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_SERVER_SYNC_IN_ PROGRESS |
License Manager synchronization process. |
|
VLS_NO_SERVER_ RUNNING |
License Manager on specified host is not available for processing license operation requests. |
|
VLS_HOST_UNKNOWN |
Invalid hostName is specified. |
|
VLS_BAD_SERVER_ MESSAGE |
Message returned by 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. |
|
LS_BAD_PARAMETER |
License Manager’s name is NULL or an empty string. |
|
LS_BUFFER_TOO_SMALL |
Buffer provided is too small. |
|
LS_NO_SUCH_FEATURE |
feature_version is non-existent. |
|
LS_NON_REDUNDANT_ SERVER_CONTACTED |
LSHOST is set to non-redundant License Manager. |
|
VLS_CALLING_ERROR |
License Manager’s name is NULL or an empty string. |
|
VLS_LEADER_NOT_ PRESENT |
Leader name is not known. |
|
VLS_NON_REDUNDANT_ SRVR |
Sets LSHOST to non-redundant License Manager. |
For a complete list of the error codes, see Licensing Library Error and Result Codes.