Share via


AtlAxCreateDialog

Creates a modeless dialog box from a dialog template provided by the user.

ATLAPI_(HWND) AtlAxCreateDialog( 
   HINSTANCE hInstance, 
   LPCWSTR lpTemplateName, 
   HWND hWndParent, 
   DLGPROC lpDialogProc, 
   LPARAM dwInitParam  
);

Parameters

  • hInstance
    [in] Identifies an instance of the module whose executable file contains the dialog box template.

  • lpTemplateName
    [in] Identifies the dialog box template. This parameter is either the pointer to a null-terminated character string that specifies the name of the dialog box template or an integer value that specifies the resource identifier of the dialog box template. If the parameter specifies a resource identifier, its high-order word must be zero and its low-order word must contain the identifier. You can use the MAKEINTRESOURCE macro to create this value.

  • hWndParent
    [in] Identifies the window that owns the dialog box.

  • lpDialogProc
    [in] Points to the dialog box procedure. For more information about the dialog box procedure, see DialogProc.

  • dwInitParam
    [in] Specifies the value to pass to the dialog box in the lParam parameter of the WM_INITDIALOG message.

Return Value

One of the standard HRESULT values.

Remarks

The resulting dialog box can contain ActiveX controls.

See CreateDialog and CreateDialogParam in the Windows SDK.

Requirements

Header: atlhost.h

See Also

Concepts

Composite Control Fundamentals

Reference

AtlAxDialogBox

Other Resources

Composite Control Global Functions