CreateDialogParam

Version 3.0

Syntax

HWND CreateDialogParam(hInstance,lpTemplateName,hWndParent,lpDialogFunc,dwInitParam)

This function creates a modeless 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. Otherwise, this function is identical to the CreateDialog function.

For more information on creating a modeless dialog box, see the description of the
CreateDialog
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 for the dialog function. For details, see the “Comments” section of the CreateDialog function.  
dwInitParam DWORD Is a 32-bit value which CreateDialogParam passes to the dialog function when it creates the dialog box.  

Return Value

The return value is the window handle of the dialog box. It is –1 if the function cannot create the dialog box.