DialogBoxParam

Version 3.0

Syntax

int DialogBoxParam(hInstance,lpTemplateName,hWndParent,lpDialogFunc,dwInitParam)

This function creates a modal dialog box, sends a WM_INITDIALOG message to the dialog function before displaying the dialog box, and passes dwInitParam as the message lParam. This message allows the dialog function to initialize the dialog-box controls.

For more information on creating a modal dialog box, see the description of the DialogBox function.

Parameter Type/Description  
hInstance HANDLE Identifies an instance of the module whose executable file contains the dialog-box template.  
lpTemplateName LPSTR Points to a character string that names the dialog-box template. The string must be a null-terminated character string.  
hWndParent HWND Identifies the window that owns the dialog box.  
lpDialogFunc FARPROC Is the procedure-instance address of the dialog function. For details, see the “Comments” section of the description of the DialogBox function.  
dwInitParam DWORD Is a 32-bit value which DialogBoxParam passes to the dialog function when it creates the dialog box.  

Return Value

The return value specifies the value of the nResult parameter in the EndDialog function that is used to terminate the dialog box. Values returned by the application's dialog box are processed by Windows and are not returned to the application. The return value is –1 if the function could not create the dialog box.