IDocHostShowUI::ShowMessage Method

---

Called by MSHTML when it needs to display a message box.

Syntax

HRESULT ShowMessage( 
    HWND hwnd,
    LPOLESTR lpstrText,
    LPOLESTR lpstrCaption,
    DWORD dwType,
    LPOLESTR lpstrHelpFile,
    DWORD dwHelpContext,
    LRESULT *plResult
);

Parameters

hwnd

Handle to the owner window.

lpstrText

Address of a string containing the text for the message box.

lpstrCaption

Address of a string containing the caption for the message box.

dwType

DWORD containing the flag type (taken from the MessageBox MB_xxxx constants).

lpstrHelpFile

Address of a string containing the Help file name.

dwHelpContext

DWORD containing the Help context identifier.

plResult

Address of an LRESULT which indicates what button the user clicked(taken from the MessageBox IDxxx constants).

Return Value

Returns one of the following values:

S_OK	Host displayed its UI. MSHTML will not display its message box.
S_FALSE	Host did not display its UI. MSHTML will display its message box.