Функция InternetErrorDlg (wininet.h)
Отображает диалоговое окно для ошибки, передаваемой в InternetErrorDlg, если существует соответствующее диалоговое окно. Если используется флаг FLAGS_ERROR_UI_FILTER_FOR_ERRORS , функция также проверяет заголовки на наличие скрытых ошибок и при необходимости отображает диалоговое окно.
Синтаксис
DWORD InternetErrorDlg(
[in] HWND hWnd,
[in, out] HINTERNET hRequest,
[in] DWORD dwError,
[in] DWORD dwFlags,
[in, out] LPVOID *lppvData
);
Параметры
[in] hWnd
Выполните обработку в родительском окне для любого необходимого диалогового окна. Если диалоговое окно не требуется и FLAGS_ERROR_UI_FLAGS_NO_UI передается в dwFlags, этот параметр может иметь значение NULL.
[in, out] hRequest
Дескриптор подключения к Интернету, используемого в вызове HttpSendRequest.
[in] dwError
Значение ошибки, для которого отображается диалоговое окно. Этот параметр может принимать одно из указанных ниже значений.
| Значение | Значение |
|---|---|
|
Позволяет пользователю подтвердить перенаправление. |
|
Отображает диалоговое окно, указывающее, что скрипт автоматического прокси-сервера недопустим. |
|
Отображает диалоговое окно с запросом пользователя о том, следует ли публиковать данные в небезопасном канале. |
|
Сервер запрашивает сертификат клиента.
Возвращаемое значение для этой ошибки всегда ERROR_SUCCESS, независимо от того, выбрал ли пользователь сертификат. Если пользователь не выбрал сертификат, при последующем запросе будет предпринята попытка анонимной проверки подлинности клиента. |
|
Уведомляет пользователя о переходе зоны на безопасный сайт. |
|
Уведомляет пользователя о пересечении зоны с безопасного сайта. |
|
Уведомляет пользователя о том, что публикуемые данные перенаправляются на незащищенный сайт. |
|
Отображает диалоговое окно с запросом имени и пароля пользователя. |
|
Указывает, что общее имя SSL-сертификата (поле имени узла) неверно. Отображает диалоговое окно Недопустимое общее имя SSL и позволяет пользователю просмотреть неверный сертификат. |
|
Отображает предупреждение для пользователя о смешанном защищенном и небезопасном содержимом. |
|
Отображает диалоговое окно с запросом пользователя о том, следует ли публиковать данные в небезопасном канале. |
|
Указывает, что общее имя SSL-сертификата (поле имени узла) неверно. Отображает диалоговое окно Недопустимое общее имя SSL и позволяет пользователю просмотреть неверный сертификат. Также позволяет пользователю выбрать сертификат в ответ на запрос сервера. |
|
Отображает предупреждение для пользователя о проблемах с сертификатом сервера. |
|
Сообщает пользователю, что срок действия SSL-сертификата истек. |
|
Отображает предупреждение для пользователя о том, что сбой проверка отзыва сертификата сервера. |
|
Отображает диалоговое окно, указывающее, что сертификат сервера отозван. |
|
Отображает диалоговое окно, указывающее, что не удалось скачать скрипт автоматического прокси-сервера. |
[in] dwFlags
Действия. Этот параметр может иметь одно или несколько из следующих значений.
| Значение | Значение |
|---|---|
|
Проверяет возвращенные заголовки на наличие ошибок. Вызов internetErrorDlg с установленным флагом после вызова HttpSendRequest для обнаружения скрытых ошибок. Например, ошибки проверки подлинности обычно скрыты, так как вызов HttpSendRequest завершается успешно, но, сканируя коды состояния, InternetErrorDlg может определить, что прокси-сервер требует проверки подлинности. |
|
Если функция выполнена успешно, сохраняет результаты диалогового окна в дескрипторове Интернета. |
|
Запрашивает у дескриптора Интернета необходимые сведения. Функция создает соответствующую структуру данных для ошибки. (Например, при сбое CN сертификата функция захватывает сертификат.) |
|
Сериализует диалоговые окна проверки подлинности для параллельных запросов в записи кэша паролей. Параметр lppvData должен содержать адрес указателя на структуру INTERNET_AUTH_NOTIFY_DATA , а клиент должен реализовать потокобезопасную, неблокирующую функцию обратного вызова. |
|
Позволяет вызывающей объекту передавать значение NULL параметру hWnd без ошибок. Используется в ситуациях, когда пользовательский интерфейс не требуется. |
[in, out] lppvData
Указатель на адрес структуры данных. Структура может отличаться для каждой ошибки, которую необходимо обработать.
Возвращаемое значение
Возвращает одно из следующих значений или значение ошибки в противном случае.
| Код возврата | Описание |
|---|---|
|
Функция успешно завершена.
Дополнительные сведения см. в разделе ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED в параметре dwError . |
|
Функция была отменена пользователем. |
|
Это означает, что функции необходимо повторить запрос. В случае проверки подлинности это означает, что пользователь нажал кнопку ОК . |
|
Дескриптор родительского окна недопустим. |
Комментарии
Всегда информируйте пользователя при возникновении любого из следующих событий:
- 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
Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | wininet.h |
| Библиотека | Wininet.lib |
| DLL | Wininet.dll |