Call Dll Function - Symantec WISESCRIPT PACKAGE EDITOR 7.0 SP2 - FOR WISE INSTALLATION STUDIO V1.0 Installation Manual

Call DLL Function

WiseScript Package Editor Reference
To complete the dialog box
Window Name
Enter the title for the dialog box.
Description
Enter text to explain the dialog box to the end user.
Prompt Name
Enter explanatory text to be displayed above the directory field.
Default Value
Enter the default location of the new directory. This appears as a default in the
directory field.
Variable Name
Enter a variable to store the chosen directory. The standard script uses the variable
MAINDIR for this purpose.
Don't Append
Mark this to prevent the default directory (Default Value field) from being appended
to the chosen directory.
Confirm If Exists
Mark this to warn the end user if the chosen directory already exists.
This action calls a .DLL function from a .DLL on the destination computer. They can be
be .DLLs you have written, .DLLs developed for WiseScript, or Windows .DLLs. You can
branch the script based on the returned results of a .DLL by setting the Action to Start
Block if Return Value True or Start While Loop.
When a WiseScript is called by a Windows Installer installation, you can also call a .DLL
by using one of the Call Custom DLL or Call DLL actions in MSI Script in Windows
Installer Editor.
To complete the dialog box
DLL Pathname
Specify the path of the .DLL file (example: %MAINDIR%\Jso32.dll).
For non-system .DLLs, the installation script must install the .DLL before the script
calls it or it will not be found. If the .DLL is only needed temporarily during
installation, copy it to the Temp directory, represented by %TEMP%.
Note
You cannot test an installation that installs and immediately calls a .DLL unless you
install the .DLL to the Temp directory. Testing installs files, then immediately
deletes them, unless they are installed to the Temp directory.
Function Name
Enter the name of the function to call. The function should be exported when
creating the .DLL. The function's parameters and return value must exactly match
those specified below (case-sensitive).
Call a function written specifically for WiseScript
When calling functions developed specifically for WiseScript, mark this option and fill
in Variables Added, Parameter String, and Action below.
WiseScript Actions
47