VLSgetQueuedClientInfoExt
Syntax
LS_STATUS_CODE VLSgetQueuedClientInfoExt (
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. Set the structSz data member of structure VLSqueuedClientInfo before calling this API. |
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. Enhanced version of the existing API VLSgetQueuedClientInfo for supporting EPOC time beyond year 2038.
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. >The structSz data member of structure VLSqueuedClientInfo is not filled correctly. |
|
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.