InstallShield 2016 » InstallScript Language Reference
Project • This information applies to InstallScript projects.
The OnMD5Error event handler responds to the MD5Error event that is generated during MD5 checking when the setup extracts a file whose MD5 hash value does not correspond to the value stored in the setup header file. When creating an InstallShield object, note that this event is not triggered in an object.
This event handler is called (when appropriate) in any setup, including a setup that uses a procedural script (a script with a program…endprogram block).
Tip • MD5 checking can detect corrupted files, which is useful during Internet setups; not doing MD5 checking can make file transfer proceed faster. You can enable or disable MD5 checking with the Advanced button in the Release Wizard's General Options panel, or with the Setup.ini file's [Startup] section's CheckMD5 key.
Syntax
OnMD5Error ( szFilename );
Parameters
|
Parameter |
Description |
|
szFilename |
Specifies the fully qualified file name of the file that generated the MD5 error. |
Return Values
|
Return Value |
Description |
|
ERR_IGNORE |
Returned to the setup by the OnMD5Error event handler to request that the setup ignore the failure to install or uninstall the file specified in OnMD5Error’s argument and continue without performing the operation. |
|
ERR_RETRY |
Returned to the setup by the OnMD5Error event handler to request that the setup attempt again to install or uninstall the file specified in OnMD5Error’s argument. |
|
ERR_ABORT |
Returned to the setup by the OnMD5Error event handler to request that the setup be aborted. |
Additional Information
An MD5Error event will be generated at run time if, after running the media builder, you replace an uncompressed file in a disk image folder. You can modify the default OnMD5Error code to automatically handle this MD5Error event rather than display a dialog. For example, to automatically ignore the MD5Error event for the file ReplacedAfterBuild.txt, which is installed to TARGETDIR, add the following lines at the beginning of the OnMD5Error code:
if szFilename = TARGETDIR ^ "ReplacedAfterBuild.txt" then
return ERR_IGNORE;
endif;
InstallShield 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |