haspds_Install
Installs the Sentinel LDK Run-time Environment.
haspds_status_t __stdcall
haspds_Install
(
unsigned long InstallMode
)
Parameters
|
InstallMode |
Specifies the characteristics of the installation process |
InstallMode Options
The following options are available.
|
HASPDS_PARAM_KILLPROC |
Terminates the processes that are currently using the Run-time Environment so that the environment can be uninstalled or installed |
|
HASPDS_PARAM_FINSTALL |
Forces installation of the Run-time Environment. Forced installation will also override any other Windows run-time environment installation that is currently in process. |
|
HASPDS_PARAM_VERBOSE |
Generates detailed log information in the installation log file (aksdrvsetup.log) |
|
HASPDS_PARAM_REPAIR |
Reinstalls the Run-time environment to repair a damaged installation. |
|
HASPDS_PARAM_FSRVSTOP |
Automatically stops the "HASP Loader" and/or "HLServer" services and restarts them after the install operation is complete. |
| HASPDS_PARAM_INCLUDE_LEGACY_DRIVER | Forces installation of the Run-time Environment with legacy drivers. For more information, see |
Return Values
|
HASPDS_STATUS_SUCCESS |
Function successfully executed |
|
HASPDS_STATUS_REBOOT_REQUIRED |
Reboot required to activate the function |
|
HASPDS_STATUS_REINSERT_REQUIRED |
Access to Sentinel key required to activate the function. Remove and reinsert Sentinel HL key. |
|
HASPDS_STATUS_INSERT_REQUIRED |
Access to Sentinel key required to activate the function. Insert Sentinel HL key. |
|
HASPDS_STATUS_FAILED |
Function failed to execute |
|
HASPDS_ERR_FILE_COPY |
The installation process cannot replace hasplms.exe because this file is in use. Stop all active applications and then rerun the installation process. |
You can retrieve additional information about an error by calling haspds_GetLastError.
Usage Notes
You can only call this function if you are logged in with administrator privileges.
Immediately after the Run-time Environment is installed or upgraded by calling this function from the 32-bit DLL (haspds_windows.dll), any V2C file contained in the same folder is applied to the relevant protection key on the machine. V2C files are not applied automatically by calling this function from the 64-bit DLL (haspds_windows_x64.dll).
Sentinel LDK Run-time Environment 7.100 or later must be present on the machine for the V2C files to be automatically applied.