SHOWMODELESSHTMLDIALOGFN Function

Defines the function type for ShowModelessHTMLDialog.

Syntax

Copy

typedef HRESULT STDAPICALLTYPE SHOWMODELESSHTMLDIALOGFN (
    HWND hwndParent,
    IMoniker *pMk,
    VARIANT *pvarArgIn,
    VARIANT *pvarOptions,
    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

Returns S_OK if successful, or an error value otherwise.

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.

Function Information

Stock Implementation	mshtml.dll
Custom Implementation	No
Header	mshtmhst.h
Import library	mshtml.dll
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows NT 4.0, Windows 95, Windows CE 4.0

See Also

Creating an HTML Resource