GetInfo Function

Description

Retrieves information about system components, according to customizable search parameters, and presents it according to customizable formats.

Syntax

hasp_status_t HASP_CALLCONV hasp_get_info(
                    const char * scope,
                    const char * format,
                    hasp_vendor_code_t vendor_code,
                    char ** info
                    )

Parameters

`scope`	Definition of the data that is to be searched in XML format.
`format`	Definition of the data to be returned by the function in XML format.
`vendor_code`	Bytes that contain the Vendor Code
`info`	Pointer to the information that is retrieved in XML format.

Return Values

HASP_SCOPE_RESULTS_EMPTY

HASP_INVALID_PARAMETER

Usage Notes

You do not need to be logged in to a Feature in order to use this function.

This function is used to specify conditions about where to search for information. In addition, it enables you to specify conditions about the format in which the retrieved information is presented. If retrieved information is appropriately formatted, it can be used as a template in the LoginScope function.

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

This function allocates memory for the information it retrieves. To release allocated memory resources, use the Free function.

You can use this function to retrieve a fingerprint only for these machines:

>the local machine

>a remote machine with a protection key that is visible to the machine where this function is performed.

NOTE If the function retrieves an empty fingerprint, see Resolving an empty fingerprint issue.