WaitOnDialog
The WaitOnDialog function displays a custom dialog. You can write your script to handle different responses from the user based on the return value from this function.
Syntax
WaitOnDialog ( szDlgName );
Parameters
| 
                                                         Parameter  | 
                                                    
                                                         Description  | 
                                                
| 
                                                         szDlgName  | 
                                                    
                                                         Specifies the ID of the dialog to display.  | 
                                                
Return Values
| 
                                                         Return Value  | 
                                                    
                                                         Description  | 
                                                
| 
                                                         dialog control ID  | 
                                                    
                                                         The ID of the dialog control that received the WM_COMMAND message.  | 
                                                
| 
                                                         IDCANCEL (2)  | 
                                                    
                                                         This message is received as a signal that the dialog is about to close.  | 
                                                
| 
                                                         DLG_ERR (-1)  | 
                                                    
                                                         This message is received if any errors occurred.  | 
                                                
| 
                                                         DLG_INIT (-100)  | 
                                                    
                                                         This message is received immediately before the dialog is displayed.  | 
                                                
Additional Information
To enable end users to cancel the installation by clicking the close button in the upper-right corner of the InstallScript dialog, the dialog must have a button control whose Control Identifier property is set to 2. For more information, see Using InstallScript to Implement Custom Dialogs.