IsDialogBoxHandled Callback Function (Urlmon)

  • Article

This function is called by Urlmon before it opens a Zones Alert/Prompt dialog box.

DWORD IsDialogBoxHandled(
  HWND hWnd,
  DWORD dwAction,
  DWORD dwPermissions,
  LPCTSTR lpszText
)

Parameters

  • hWnd
    [in] Handle of the parent window of the dialog box.

  • dwAction
    [in] Specifies the URL action code. The following table describes the valid action codes, which are defined in urlmon.idl.

    Action code Default dialog box message
    URLACTION_DOWNLOAD_SIGNED_ACTIVEX (0x00001001) "When software (an ActiveX control) is signed, it is possible to tell who published it. Do you want to allow signed software to be downloaded?"
    URLACTION_DOWNLOAD_UNSIGNED_ACTIVEX (0x00001004) "Do you want to allow software such as ActiveX controls to be downloaded?"
    URLACTION_ACTIVEX_RUN (0x00001200) "Do you want to allow software such as ActiveX controls and plug-ins to run?"
    URLACTION_ACTIVEX_OVERRIDE_OBJECT_SAFETY (0x00001201) "An ActiveX control on this page might be unsafe to interact with other parts of the page. Do you want to allow this interaction?"
    URLACTION_ACTIVEX_OVERRIDE_DATA_SAFETY (0x00001202) "Some software (an ActiveX control) on this page might be unsafe. Do you want to allow it to run?"
    URLACTION_ACTIVEX_OVERRIDE_SCRIPT_SAFETY (0x00001203) "Some software (an ActiveX control) on this page might be unsafe. Do you want to allow it to run?"
    URLACTION_ACTIVEX_CONFIRM_NOOBJECTSAFETY (0x00001204) "An ActiveX control on this page might be unsafe to interact with other parts of the page. Do you want to allow this interaction?"
    URLACTION_SCRIPT_RUN (0x00001400) "Scripts are usually safe. Do you want to allow scripts to run? "
    URLACTION_SCRIPT_OVERRIDE_SAFETY (0x00001401) "Some software (a script) on this page might be unsafe. Do you want to allow it to run?"
    URLACTION_SCRIPT_JAVA_USE (0x00001402) "Do you want to allow scripts to access Java applets?"
    URLACTION_SCRIPT_SAFE_ACTIVEX (0x00001405) "A script is accessing some software (an ActiveX control) on this page which has been marked safe for scripting. Do you want to allow this?"
    URLACTION_CROSS_DOMAIN_DATA (0x00001406) "This page is accessing information that is not under its control. This poses a security risk. Do you want to continue?"
    URLACTION_SCRIPT_PASTE (0x00001407) "Do you want to allow this page to paste information from your clipboard?"
    URLACTION_HTML_FONT_DOWNLOAD (0x00001604) "This page uses fonts that need to be temporarily installed. This is usually safe. Do you want to allow these fonts to be downloaded?"
    URLACTION_HTML_JAVA_RUN (0x00001605) "Do you want to allow Java applets to run?"
    URLACTION_HTML_USERDATA_SAVE ((0x00001606) "Will you allow this Web site to save a file on your computer?"
    URLACTION_HTML_SUBFRAME_NAVIGATE (0x00001607) "Allow sub-frames to navigate across different domains?"
    URLACTION_CREDENTIALS_USE (0x00001A00) "This site is requesting a password or a personal certificate. Do you want to connect to this site using your personal credentials?"
    URLACTION_AUTHENTICATE_CLIENT (0x00001A01) "Do you want to connect to this site even though the client authentication is not possible?"
    URLACTION_COOKIES (0x00001A02) "To allow this Web site to provide information personalized for you, will you allow it to put a small file (called a cookie) on your computer?"
    URLACTION_COOKIES_SESSION (0x00001A03) "Will you allow this Web site to put a small file (called a cookie) on your computer for this session only?"
    URLACTION_CLIENT_CERT_PROMPT (0x00001A04) "Allow client authentication without prompting when only one certificate is available?"
    URLACTION_COOKIES_THIRD_PARTY (0x00001A05) "Allow third party cookies stored on your computer (only effective if cookies can be stored on your computer)."
    URLACTION_COOKIES_SESSION_THIRD_PARTY (0x00001A06) "Allow third party per-session cookies (not stored - this setting is only effective if per-session cookies are enabled)."
    URLACTION_SHELL_INSTALL_DTITEMS (0x00001800) "Do you want to add an Active Desktop item to your desktop?"
    URLACTION_SHELL_MOVE_OR_COPY (0x00001802) "Do you want to move or copy files from this zone?"
    URLACTION_SHELL_FILE_DOWNLOAD (0x00001803) "Do you want to allow a file to be downloaded?"
    URLACTION_SHELL_VERB (0x00001804) "Running a system command on this item might be unsafe. Do you wish to continue?"
    URLACTION_SHELL_WEBVIEW_VERB (0x00001805) "Opening a file from this location may not be safe and is not allowed with your current security settings. Are you sure you want to open a file from this location?"
    URLACTION_HTML_SUBMIT_FORMS (0x00001601) "Sending HTML forms is as safe as sending e-mail. Do you want to able to send HTML forms?"
    URLACTION_HTML_SUBMIT_FORMS_FROM (0x00001602) "Sending HTML forms is as safe as sending e-mail. Do you want to able to send HTML forms?"
    URLACTION_HTML_SUBMIT_FORMS_TO 0x00001603) "Sending HTML forms is as safe as sending e-mail. Do you want to able to send HTML forms?"

  • dwPermissions
    [in] Specifies the policy set for the particular action. In this callback function, the value is always URLPOLICY_QUERY.

  • lpszText
    [in] String that contains the alert message to be displayed.

Return Values

The IsDialogBoxHandled function should return one of the following values:

  • ZALERT_YES if the user selected Yes or OK.
  • ZALERT_NO if the user selected No or Cancel.
  • ZALERT_YESPERSIST if user selected Yes and the Don't show this again check box.
  • ERROR_CALL_NOT_IMPLEMENTED to instruct Urlmon to use the default message box.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Urlmonui.h.
Link Library: Urlmonui.lib.

See Also

Replacing the Urlmon User Interface

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.