ShowHTMLDialog function

Creates a modal dialog box that displays HTML.

Syntax

HRESULT ShowHTMLDialog(
       HWND     hwndParent,
       IMoniker *pMk,
       VARIANT  *pvarArgIn,
  _In_ LPWSTR   pchOptions,
       VARIANT  *pvarArgOut
);

Parameters

  • hwndParent
    A handle to the parent of the dialog box.

  • pMk
    The address of an IMoniker interface from which the HTML for the dialog box is loaded.

  • pvarArgIn
    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.

  • pchOptions [in]
    The window ornaments for the dialog box. This parameter can be NULL or the address of a string that contains a combination of values separated by semicolons (;). See the description of the features parameter of the IHTMLWindow2::showModalDialog method of the window object for detailed information.

  • pvarArgOut
    The address of a VARIANT structure that contains the output data for the dialog box. This VARIANT receives the data that was placed in the window object's IHTMLDialog::returnValue property. This parameter can be NULL.

Return value

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

Remarks

To use ShowHTMLDialog, which is implemented in Mshtml.dll, you must dynamically load and call this function by using the LoadLibrary function and the GetProcAddress function. The proper function type for ShowHTMLDialog is defined in Mshtmhst.h in the SHOWHTMLDIALOGFN type. A full sample that demonstrates the use of ShowHTMLDialog is available on the ShowHTMLDialog Sample Source Page.

Security Warning: Using LoadLibrary incorrectly can compromise the security of your application by loading the wrong DLL. Refer to the LoadLibrary documentation for information on how to correctly load DLLs with different versions of Windows.

Examples

The following example shows the basic steps to load Mshtml.dll, obtain the address of ShowHTMLDialog using GetProcAddress, create a URL moniker, and call ShowHTMLDialog.

   HINSTANCE hinstMSHTML = LoadLibrary(TEXT("MSHTML.DLL"));

   if (hinstMSHTML == NULL)
   {
       // Error loading module -- fail as securely as possible
       return;
   }
   
   SHOWHTMLDIALOGFN* pfnShowHTMLDialog;
   pfnShowHTMLDialog = (SHOWHTMLDIALOGFN*)GetProcAddress(hinstMSHTML,
                                                              TEXT("ShowHTMLDialog"));
   if (pfnShowHTMLDialog)
   {
       IMoniker *pURLMoniker;
       BSTR bstrURL = SysAllocString(L"http://www.example.com/dialogsource.htm");
       CreateURLMoniker(NULL, bstrURL, &pURLMoniker);

       if (pURLMoniker)
       {
           (*pfnShowHTMLDialog)(NULL, pURLMoniker, NULL, NULL, NULL);
            pURLMoniker->Release();
       }

       SysFreeString(bstrURL);
   }

   FreeLibrary(hinstMSHTML);

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mshtmhst.h

DLL

Mshtml.dll; Mshtml.dll

See also

Creating an HTML Resource