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

Статья
11/20/2024

[InternetCheckConnection доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях. Вместо этого используйте NetworkInformation.GetInternetConnectionProfile или интерфейсы NLM. ]

Позволяет приложению проверить, можно ли установить подключение к Интернету.

Синтаксис

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Параметры

[in] lpszUrl

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

[in] dwFlags

Параметры. FLAG_ICC_FORCE_CONNECTION — единственный доступный в настоящее время флаг. Если этот флаг задан, он заставляет подключение. Подключение сокетов выполняется в следующем порядке:

Если lpszUrl не являетсяNULL, значение узла извлекается из него и используется для проверки ping этого конкретного узла.
Если lpszUrlnull и есть запись во внутренней базе данных сервера для ближайшего сервера, значение узла извлекается из записи и используется для проверки ping этого сервера.

[in] dwReserved

Этот параметр зарезервирован и должен иметь значение 0.

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

Возвращает TRUE, если подключение выполнено успешно или FALSE в противном случае. Чтобы получить код ошибки, используйте GetLastError. ERROR_NOT_CONNECTED возвращается GetLastError, если подключение невозможно сделать или если база данных сокетов является безусловно автономной.

Замечания

InternetCheckConnection не рекомендуется. InternetCheckConnection не работает в средах, использующих веб-прокси-сервер для доступа к Интернету. В зависимости от среды используйте NetworkInformation.GetInternetConnectionProfile или интерфейсы NLM для проверки доступа к Интернету.

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

Заметка

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

Требования

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

См. также

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

функций WinINet

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