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. |
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.