loginScope Method

Package: Aladdin

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

boolean Aladdin.Hasp.loginScope ( String scope,
                                  String vendor_code
                                )

Parameters

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

Return Values

true/false - indicates success or failure

Usage Notes

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

The Feature ID must first be specified using the Hasp constructor.

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 method call cannot succeed.

You can open simultaneous login sessions.

This method does not work with legacy Sentinel HASP Features.

NOTE   When this method 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.

If detaching of licenses is enabled, an automatic detach occurs when the LoginScope method is called.

You can perform an on-demand detach by calling the Transfer method. For details, see:

>Using XML Tags to Define Scope (Examples for Cloud Licensing)

> Detaching an SL AdminMode or SL UserMode License

Related Topics

Checking the License Expiration Date of a Feature

GetLastError Method

GetInfo Method

GetSessionInfo Method

Login Method

Logout Method

About XML Tags