Share via


AtlAxCreateDialog

 

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

Important

This function cannot be used in applications that execute in the Windows Runtime.

Syntax

      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

Composite Control Global Functions
ATL Composite Control Fundamentals
AtlAxDialogBox