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 Global Functions

Composite Control Fundamentals

AtlAxDialogBox