LoginScope Function

Description

Logs into a Feature to establish a session, according to predefined search parameters.

All Licensing API functions are compatible with remote License Managers and with the local License Manager, depending on the scope specified.

Syntax

hasp_status_t HASP_CALLCONV hasp_login_scope(
              hasp_feature_t feature_id,
              const char * scope,
              hasp_vendor_code_t vendor_code,
              hasp_handle_t * handle)

Parameters

feature_id

Unique identifier for a specific Feature stored in a Sentinel protection key.

scope

Definition of the data that is to be searched for the Sentinel LDK licenses, in XML format. For more information, see Scope Input XML Tags.

vendor_code

Bytes that contain the Vendor Code

handle

Pointer to the resulting session handle

Return Values

HASP_STATUS_OK

HASP_FEATURE_NOT_FOUND

HASP_SCOPE_RESULTS_EMPTY

HASP_HASP_NOT_FOUND

HASP_TMOF

HASP_INSUF_MEM

HASP_INV_VCODE   

HASP_NO_DRIVER

HASP_OLD_DRIVER

HASP_NO_BATTERY_POWER

HASP_UNKNOWN_VCODE

HASP_INVALID_PARAMETER

HASP_LOCAL_COMM_ERR

HASP_REMOTE_COMM_ERR

HASP_FEATURE_EXPIRED

HASP_TOO_MANY_USERS

HASP_OLD_LM

HASP_DEVICE_ERR

HASP_TIME_ERR

HASP_TS_DETECTED

HASP_HARDWARE_MODIFIED

HASP_NO_VLIB

HASP_INV_VLIB

HASP_OLD_VLIB

HASP_INVSPEC

HASP_VM_DETECTED

HASP_VS_DETECTED

HASP_DUPLICATE_HOSTNAME

HASP_MISSING_LM

HASP_FEATURE_INSUFFICIENT_EXECUTION_COUNT

HASP_REMOTE_SHARING_VIOLATION

HASP_MACHINE_DENIED

HASP_MACHINE_DISABLED

HASP_IDENTITY_RATE_LIMIT_EXCEEDED

HASP_IDENTITY_EXPIRED

HASP_IDENTITY_RATE_LIMIT_EXCEEDED

HASP_FEATURE_START_DATE_NOT_REACHED

HASP_IDENTITY_TEMPORARILY_NOT_ACCESSIBLE

Usage Notes

This function is used to specify conditions that specify where login information is to be searched for.

If the Feature license expires while the login session is active, the login session (and therefore, the application) is allowed to continue. This is due to the fact that terminating the session may result in corruption of the application output or data.

The required Vendor Codes are stored in a VendorCodes folder in your system. Without the correct Vendor Code, the function call cannot succeed.

You can open simultaneous login sessions.

This function does not work with legacy Sentinel HASP Features.

NOTE   When this function is called for a Feature with a license type of Execution Count, Expiration Date, or Time Period, a write cycle is performed for the Sentinel protection key. Sentinel HL keys are certified to withstand a specific number of write cycles. For information on the number of write cycles for which Sentinel HL keys are certified, see the Sentinel HL Data Sheet.

Related Topics

Checking the License Expiration Date of a Feature

GetInfo Function

GetSessionInfo Function

Login Function

Logout Function

About XML Tags

hasp_login_scope screen