Функция InternetConfirmZoneCrossingW (wininet.h)

Статья
11/20/2024

Проверяет наличие изменений между защищенными и небезопасными URL-адресами. Всегда сообщайте пользователю, когда происходит изменение в безопасности между двумя URL-адресами. Как правило, приложение должно разрешить пользователю подтвердить изменение через взаимодействие с диалоговым окном.

Синтаксис

DWORD InternetConfirmZoneCrossingW(
  [in] HWND   hWnd,
  [in] LPWSTR szUrlPrev,
  [in] LPWSTR szUrlNew,
  [in] BOOL   bPost
);

Параметры

[in] hWnd

Обработка родительского окна для любого обязательного диалогового окна.

[in] szUrlPrev

Указатель на строку, завершающуюся значением NULL, которая указывает URL-адрес, который был просмотрован до выполнения текущего запроса.

[in] szUrlNew

Указатель на строку, завершающуюся значением NULL, которая указывает новый URL-адрес, запрошенный пользователем для просмотра.

[in] bPost

Не реализовано.

Возвращаемое значение

Возвращает одно из следующих значений.

Возвращаемый код	Описание
ERROR_SUCCESS	Пользователь подтвердил, что он был в порядке продолжения или не требуется входных данных пользователей.
ERROR_CANCELLED	Пользователь отменил запрос.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для выполнения запроса.

Замечания

Всегда сообщайте пользователю, когда происходит изменение уровня безопасности, или вы рискуете подставить пользователя на непреднамеренное раскрытие информации.

Как и все остальные аспекты API WinINet, эта функция не может быть безопасно вызвана из dllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера microsoft Windows HTTP Services (WinHTTP).

Заметка

Заголовок wininet.h определяет InternetConfirmZoneCrossing как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

включение функций Интернета

функций WinINet

Поделиться через