Go to the source code of this file.
To suggested way to install the SmartKey drivers is to simply call only the required SkeyInstallPar(), SkeyInstallUSB() and SkeyInstallGSS2() functions.
If a function fails with the error code SKEYINST_PROBE_INSTALL_BUSY you need to ask at the user to close any other installation process and retry. If a function fails with the error code SKEYINST_PROBE_FAIL and with GetLastError() equal at ERROR_ACCESS_DENIED (5) you need to ask at the user to became Administrator and restart the installation. If a function fails with any other error code the installation is failed.
If a function returns with the code SKEYINST_OK, the operation is completed with success. If a function returns with the code SKEYINST_WARNING_MUST_REBOOT, you must reboot the system to complete the operation. If a function returns with the code SKEYINST_WARNING_MUST_INSERT, you need to ask at the used to insert the SmartKey to complete the process.
You can eventually use the SkeyProbe() function to check the Not Administrator and Busy conditions in advance.
Please note that you don't need to check if a driver is already installed before calling the Install() functions. If the driver is already installed and updated these functions do nothing.
|
Generic failure. The operation is failed for a generic error. You can call the SkeyGetLastError() function to get the Windows error code. If an install operation is done without the Administrator rights the SkeyGetLastError() function returns the value 5 (ERROR_ACCESS_DENIED). |
|
This operation is unsupported in this operating system. You can't call the function in this operation system. |
|
Another installation is in progress. You must ask at the user to complete any installation process in progress and then retry. A good behaviours is:
Note that the Windows XP tooltip, shown on the lower right corner of the screen after an hardware installation, must be closed because is part of the installation process. |
|
Operation completed successfully.
|
|
Check if the current user has the Administrator permission. In Windows 9x it always returns TRUE. |
|
Check if the GSS 2 driver is available for installing.
|
|
Check if the GSS 2 driver is installed.
|
|
Check if the GSS 2 driver is active.
|
|
Return the version of the installed GSS 2 driver. The version number is a 4 byte code packed in a DWORD value. |
|
Check if the Windows Installer is busy. Until the Windows Installer is busy you cannot call any other function. |
|
Check if the Parallel driver is available for installing.
|
|
Check if the Parallel driver is installed.
|
|
Check if the Parallel driver is active.
|
|
Return the version of the installed Parallel driver. The version number is a 4 byte code packed in a DWORD value. |
|
Check if the USB driver is available for installing.
|
|
Check if the USB driver is installed. This command doesn't check if the correct driver is installed, but only if a generic driver connected at the token is installed. If the user install manually the "Windows Null Driver", this function reports that a driver is installed. |
|
Check if the USB driver is active.
|
|
Return the version of the installed USB driver. The version number is a 4 byte code packed in a DWORD value. |
|
Operation completed successfully, but you must insert the token to complete the operation. This code is generally returned after the installation of the USB Driver on Windows 9x/Me/2000/XP. |
|
Operation completed successfully, but you must reboot to complete the operation. This code is generally returned after the forced uninstallation. |
|
Forced uninstallation of the GSS 2 (eugss*.sys) driver. The driver is uninstalled with force removing any reference on the filesystem and registry.
|
|
Forced uninstallation of the Parallel driver. The driver is uninstalled with force removing any reference on the filesystem and registry.
|
|
Forced uninstallation of the USB driver. The driver is uninstalled with force removing any reference on the filesystem and registry.
|
|
Get the last Windows error code.
|
|
Installation of the GSS 2 (eugss*.sys) driver. All the required drivers for the GSS2 SmartKey are installed. If in the current operating systen no driver is needed, nothing is done and the function returns with success.
|
|
Installation of the Parallel driver. All the required drivers for the Parallel SmartKey are installed. If in the current operating systen no driver is needed, nothing is done and the function returns with success. The driver is started as "Automatic". If you need to use the SmartKey in a Windows Service, you must add a dependency on the eusk2par driver, to prevent the service to start before the SmartKey driver.
|
|
Installation of the USB driver. All the required drivers for the USB SmartKey are installed. On Windows NT the USB Phoenix stack is also installed.
|
|
Select the log file to use. If you specify a log file, when you call one of the install or uninstall functions a very detailed report of all the operations is generated. This report can be used to debug problematic installation cases.
|
|
Probe for a driver status information.
|
|
Uninstallation of the GSS 2 (eugss*.sys) driver.
|
|
Uninstallation of the Parallel driver. The previous installed Parallel drivers are uninstalled. If no driver is installed nothing is done and the function returns with success.
|
|
Uninstallation of the USB driver. The previous installed USB drivers are uninstalled. If no driver is installed nothing is done and the function returns with success.
|