VLSgetHandleStatus

Syntax

int VLSgetHandleStatus (	 	 
LS_Handle	 	lshandle ); 	 	 
Argument Description
lshandle

Identifies the handle previously returned by VLSqueuedRequest.

Description

Reports the current status of the handle.

Returns

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

Error Code Description

LS_BADHANDLE

Invalid handle. Handle is already released and destroyed from previous license operations.

LS_NORESOURCES

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

VLS_AMBIGUOUS_ HANDLE

lshandle is an ambiguous handle; it is not exclusively active or exclusively queued.

VLS_ACTIVE_HANDLE

lshandle is an active handle.

VLS_QUEUED_HANDLE

lshandle is a queued handle.

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