CreateDialogParam

HWND CreateDialogParam(hinst, lpszDlgTemp, hwndOwner, dlgprc, lParamInit)
HANDLE hinst;	/* handle of application instance	*/
LPCTSTR lpszDlgTemp;	/* address of name of dialog box template	*/
HWND hwndOwner;	/* handle of owner window	*/
DLGPROC dlgprc;	/* instance address of dialog box procedure	*/
LPARAM lParamInit;	/* initialization value	*/

This function creates a modeless dialog box, sends a WM_INITDIALOG message to the dialog function before displaying the dialog box, and passes lParamInit 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.

Parameters

hinst

Identifies an instance of the module whose executable file contains the dialog-box template.

lpszDlgTemp

Points to a character string that names the dialog-box template. The string must be a null-terminated character string.

hwndOwner

Identifies the window that owns the dialog box.

dlgprc

Is the procedure-instance address for the dialog function. For details, see the Comments section of the CreateDialog function.

lParamInit

Is a value which CreateDialogParam passes as the lParam of a WM_INITDIALOG message 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 NULL if the function cannot create the dialog box.

Comments

The CreateDialogParam function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set installed).