SHOWMODELESSHTMLDIALOGFN function

Defines the function type for ShowModelessHTMLDialog.

Syntax

HRESULT STDAPICALLTYPE SHOWMODELESSHTMLDIALOGFN(
  _In_  HWND         hwndParent,
  _In_  IMoniker     *pMk,
  _In_  VARIANT      *pvarArgIn,
  _In_  VARIANT      *pvarOptions,
  _Out_ IHTMLWindow2 **ppWindow
);

Parameters

• hwndParent [in]
  A handle to the window that will be the owner of the dialog box. This window will be disabled for the life of the dialog box. If this value is NULL, the dialog box is not owned.

• pMk [in]
  The address of an IMoniker interface that identifies the source of the HTML that will be contained in the dialog box.

• pvarArgIn [in]
  The address of a VARIANT structure that contains the input data for the dialog box. The data passed in this VARIANT is placed in the window object's IHTMLDialog::dialogArguments property. This parameter can be NULL.

• pvarOptions [in]
  The window ornaments for the dialog box. This parameter can be NULL or VARIANT of type VT_BSTR that contains a combination of values separated by semicolons (;). For detailed information, see the description of the features parameter of the IHTMLWindow2::showModalDialog method of the window object.

• ppWindow [out]

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function creates a modeless dialog box that contains HTML. The function does not return until the dialog box has been dismissed. To obtain the address of this function, load Mshtml.dll with LoadLibrary, and then retrieve the address of ShowModelessHTMLDialog with GetProcAddress.

For additional information on dialog boxes, dialog options, and the default unit of measure used, see IHTMLWindow2::showModalDialog.

Requirements

See also

Creating an HTML Resource