Export (0) Print
Expand All
Expand Minimize
1 out of 7 rated this helpful - Rate this topic

InternetErrorDlg function

Displays a dialog box for the error that is passed to InternetErrorDlg, if an appropriate dialog box exists. If the FLAGS_ERROR_UI_FILTER_FOR_ERRORS flag is used, the function also checks the headers for any hidden errors and displays a dialog box if needed.

Syntax


DWORD InternetErrorDlg(
  _In_     HWND hWnd,
  _Inout_  HINTERNET hRequest,
  _In_     DWORD dwError,
  _In_     DWORD dwFlags,
  _Inout_  LPVOID *lppvData
);

Parameters

hWnd [in]

Handle to the parent window for any needed dialog box. If no dialog box is needed and FLAGS_ERROR_UI_FLAGS_NO_UI is passed to dwFlags, then this parameter can be NULL.

hRequest [in, out]

Handle to the Internet connection used in the call to HttpSendRequest.

dwError [in]

Error value for which to display a dialog box. This parameter can be one of the following values.

ValueMeaning
ERROR_HTTP_REDIRECT_NEEDS_CONFIRMATION

Allows the user to confirm the redirect.

ERROR_INTERNET_BAD_AUTO_PROXY_SCRIPT

Displays a dialog indicating that the auto proxy script is invalid.

ERROR_INTERNET_CHG_POST_IS_NON_SECURE

Displays a dialog asking the user whether to post the given data on a non-secure channel.

ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED

The server is requesting a client certificate.

The return value for this error is always ERROR_SUCCESS, regardless of whether or not the user has selected a certificate. If the user has not selected a certificate then anonymous client authentication will be attempted on the subsequent request.

ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR

Notifies the user of the zone crossing to a secure site.

ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR

Notifies the user of the zone crossing from a secure site.

ERROR_INTERNET_HTTPS_HTTP_SUBMIT_REDIR

Notifies the user that the data being posted is now being redirected to a non-secure site.

ERROR_INTERNET_INCORRECT_PASSWORD

Displays a dialog box requesting the user's name and password.

ERROR_INTERNET_INVALID_CA

Indicates that the SSL certificate Common Name (host name field) is incorrect. Displays an Invalid SSL Common Name dialog box and lets the user view the incorrect certificate.

ERROR_INTERNET_MIXED_SECURITY

Displays a warning to the user concerning mixed secure and non-secure content.

ERROR_INTERNET_POST_IS_NON_SECURE

Displays a dialog asking the user whether to post the given data on a non-secure channel.

ERROR_INTERNET_SEC_CERT_CN_INVALID

Indicates that the SSL certificate Common Name (host name field) is incorrect. Displays an Invalid SSL Common Name dialog box and lets the user view the incorrect certificate. Also allows the user to select a certificate in response to a server request.

ERROR_INTERNET_SEC_CERT_ERRORS

Displays a warning to the user showing the issues with the server certificate.

ERROR_INTERNET_SEC_CERT_DATE_INVALID

Tells the user that the SSL certificate has expired.

ERROR_INTERNET_SEC_CERT_REV_FAILED

Displays a warning to the user showing that the server certificate’s revocation check failed.

ERROR_INTERNET_SEC_CERT_REVOKED

Displays a dialog indicating that the server certificate is revoked.

ERROR_INTERNET_UNABLE_TO_DOWNLOAD_SCRIPT

Displays a dialog indicating that the auto proxy script could not be downloaded.

 

dwFlags [in]

Actions. This parameter can be one or more of the following values.

ValueMeaning
FLAGS_ERROR_UI_FILTER_FOR_ERRORS

Scans the returned headers for errors. Call InternetErrorDlg with this flag set following a call to HttpSendRequest so as to detect hidden errors. Authentication errors, for example, are normally hidden because the call to HttpSendRequest completes successfully, but by scanning the status codes, InternetErrorDlg can determine that the proxy or server requires authentication.

FLAGS_ERROR_UI_FLAGS_CHANGE_OPTIONS

If the function succeeds, stores the results of the dialog box in the Internet handle.

FLAGS_ERROR_UI_FLAGS_GENERATE_DATA

Queries the Internet handle for needed information. The function constructs the appropriate data structure for the error. (For example, for Cert CN failures, the function grabs the certificate.)

FLAGS_ERROR_UI_SERIALIZE_DIALOGS

Serializes authentication dialog boxes for concurrent requests on a password cache entry. The lppvData parameter should contain the address of a pointer to an INTERNET_AUTH_NOTIFY_DATA structure, and the client should implement a thread-safe, non-blocking callback function.

FLAGS_ERROR_UI_FLAGS_NO_UI

Allows the caller to pass NULL to the hWnd parameter without error. To be used in circumstances in which no user interface is required.

 

lppvData [in, out]

Pointer to the address of a data structure. The structure can be different for each error that needs to be handled.

Return value

Returns one of the following values, or an error value otherwise.

Return codeDescription
ERROR_SUCCESS

The function completed successfully.

For more information, see ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED in the dwError parameter.

ERROR_CANCELLED

The function was canceled by the user.

ERROR_INTERNET_FORCE_RETRY

This indicates that the function needs to redo its request. In the case of authentication this indicates that the user clicked the OK button.

ERROR_INVALID_HANDLE

The handle to the parent window is invalid.

 

Remarks

Always inform the user when any of the following events occur:

  • ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR
  • ERROR_INTERNET_INVALID_CA
  • ERROR_INTERNET_POST_IS_NON_SECURE
  • ERROR_INTERNET_SEC_CERT_CN_INVALID
  • ERROR_INTERNET_SEC_CERT_DATE_INVALID
Unless the user has explicitly chosen not to be informed of these events, failure to do so exposes the user involuntarily to a significant security risk.

Like all other aspects of the WinINet API, this function cannot be safely called from within DllMain or the constructors and destructors of global objects.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

See also

Enabling Internet Functionality
WinINet Functions

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.