Dll Parameter Settings - Symantec WISESCRIPT EDITOR 7.0 SP2 - FOR WISE INSTALLATION EXPRESS V1.0 Installation Manual

DLL Parameter Settings

WiseScript Editor Reference
Start block if function returns true
If the .DLL function returns non-zero, all actions between this action and its
matching End action are executed. Otherwise these actions are skipped.
Loop while function returns true
The actions between this action and the matching End action (including the .DLL
call) are executed repeatedly until the .DLL function returns zero.
Perform while loop at least once.
If you select Loop while function returns true, mark this to force the loop to
execute once before the test is performed. If the check box is cleared, the loop is
executed if the condition is true, but is not executed if the condition is false.
Call a function with variable parameter list
(Enables the options below.) Mark this to call .DLLs not specifically written for
WiseScript. These .DLLs cannot access any of the installation's internal variables,
but you can pass this information to them. Below, specify the required parameters
and Return Value Type.
Return Value Type
Select the data type of the return value, which are described in
Settings.
Returned Variable
Select or enter a variable to store the returned value.
Get Last Error Variable
When you call a Windows API function that uses the GetLastError() function to
report errors, select a variable to hold the return value of that function. Doing so
ensures that GetLastError() is called immediately following your function to prevent
problems that can occur when you debug the WiseScript.
Keep DLL loaded in memory after returning from function
By default, the Call DLL Function action loads a .DLL, calls a function in that .DLL,
and then unloads the .DLL. If you call many functions from a certain .DLL, then the
unload is unnecessary and can cause problems with certain .DLLs. To leave this .DLL
loaded, check this check box.
Hide progress bar before calling function
If the .DLL has UI, you can us this to hide the progress bar.
If you write a .DLL, use CALLBACK or WINAPI in the declaration of the .DLL.
For help with .DLL development, review sample source code, such as GETCPU32.C, in
the DLL subdirectory of this product's installation directory. Also included is sample
source code for C and Delphi .DLLs written for WiseScript.
Calling Visual Basic ActiveX controls is not supported.
The sample scripts Application kill.wse, CheckDiskSpace.wse, Color.wse, and
Prompt.wse use this action. For details on sample scripts, see ScriptHelp.htm in the
Samples subdirectory of this product's installation directory.
The DLL Parameter Settings dialog box appears when you add a new parameter to a Call
DLL Function action. Add parameters in the order in which they appear in the .DLL's
function prototype.
WiseScript Actions
DLL Parameter
48