VLSgetQueuedClientInfo
Syntax
LS_STATUS_CODE VLSgetQueuedClientInfo (
unsigned char *feature name,
unsigned char *version,
int index,
char *unused1,
VLSqueuedClientInfo *client_info );| Argument | Description |
| feature_name |
Feature name of the client for which we are requesting information. An IN parameter. |
| version |
Version for which licenses are requested. Must be unique, for the associated feature. An IN parameter. |
| index |
Index of the client with the License Manager, for a particular feature. An IN parameter. |
| unused1 | Unused. Pass NULL as value. |
| client_info |
The structure in which information will be returned. Pointer to the VLSqueuedClientInfo structure, which specifies the client information. An OUT parameter. |
Description
Fills the structure pointed by client_info to a structure containing the current information of a queued client identified by specified feature_name, version, and index.
Returns
The status code LS_SUCCESS is returned if successful. Otherwise, it will return the following error codes:
| Error Code | Description |
|
VLS_CALLING_ERROR |
>client_info parameter is NULL. >index is negative. >Attempted to use standalone mode with network only library, or network mode with standalone library. |
|
VLS_APP_UNNAMED |
>feature_name is NULL >version is NULL Both feature and version cannot be NULL |
|
VLS_NO_LICENSE_GIVEN |
Finished retrieving client information for all the clients. |
|
VLS_NO_SUCH_FEATURE |
License Manager does not have a license that matches requested feature, version and capacity. |
|
VLS_MULTIPLE_ VENDORID_FOUND |
The License Manager has licenses for the same feature and version from multiple vendors. It is ambiguous which feature is requested. |
|
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 |
The License Manager has not been set and is unable to determine which License Manager to use. |
|
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 for servicing the 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.