hasp_get_sessioninfo Screen

Description

Retrieves information regarding a session context. The hasp_get_sessioninfo screen contains the following fields:

Handle

The handle for the current session.

Format Template

Select the template that specifies the information to be retrieved by the function. The selected template is displayed in the Format field. You can modify the XML code in the Format field as necessary.

The following preset templates are available:

> HASP_KEYINFO - use this format template to retrieve information about the Sentinel protection key.

>HASP_SESSIONINFO - use this format template to retrieve information about the current session.

>Create C2V - use this format template to retrieve information about a license update contained in a C2V file.

Format

Displays, in XML code, the content and format of the information to be retrieved by the function. You can modify the XML code as necessary.

The Format string enables data to be returned in virtually any nesting-level context. For example, you may choose to retrieve data related to containers and what they contain (for example, licenses), or you may choose to retrieve that same data as licenses and their containers.

The root tag defines the root tag that you want to return. If the haspscope root tag is selected, the output will be in a format suitable for use in the hasp_login_scope function.

Click Check XML Code to validate the XML code that you specified the Format field.

Information

Displays the requested information about the key, session, or license update. For information on the XML tags used to format the information, see Format XML Tags.

Select a template and click Manage Templates to display the Format Template Manager dialog box.

Click Save Template to open the Save Template dialog box.

You can overwrite an existing template, or save a modified template with a new name.

Click OK to save, or Cancel to close the dialog box without saving.

Click Execute to transfer the function and field definitions to the Sentinel Licensing API. After the function is executed, corresponding values are displayed in the status fields and the executed function call is logged in the API Call History.

After the function is executed, the retrieved information is displayed in the Information field.

Click Save As to save this output.

Click Save As Scope Template to save this output as a Scope template (assuming that the output was correctly formatted).

Related Topics

Generated Code Pane

API Call History

hasp_login screen

Function Pane

Accessing the Sentinel Licensing API Reference

hasp_get_sessioninfo()

Format XML Tags

Format Template Manager

XML Tags